Get calendar

Fetch calendar information by a specific equity(s) or watchlist(s)

GET /calendar/

Parameter	Type	DataType	Description
modified_since	query	datetime	Returns events modified since this date
event_type	query	string	Filter by: earnings, earnings_release, presentation, investor_meeting, special_situation
start_date	query	datetime	Fetch events greater than or equal to this date (default: -2 weeks from the query date)
end_date	query	datetime	Fetch events less than or equal to this date (default: +2 weeks from the query date)
bloomberg_ticker	query	string	Filter events to one or more Bloomberg tickers (comma-separated)
isin	query	string	Filter events to one or more ISINs (comma-separated)
permid	query	string	Filter to one or more PermID identifiers (comma-separated)
ric	query	string	Filter events to one or more Reuters/Refinitiv RICs (comma-separated)
ticker	query	string	Filter events to one or more local tickers (comma-separated)
watchlist_id	query	integer	Filter to one or more watchlist IDs (comma-separated)
company_rollup	query	boolean	Whether to roll-up any matches to the corresponding company entity
include_deleted	query	boolean	Whether to include deleted event records (for reconciliation)
include_private	query	boolean	Whether to include private events
from_index	query	integer	The index from which to start returning results
size	query	integer	The number of events to return (max: 1,000)
sort_key	query	string	Sort by event_id_asc, event_id_desc, event_date_asc (default), and event_date_desc

NOTE

modified_since can be used to synchronize with an external system.
All dates (event_date, created, modified) are in Eastern Time (America/New_York timezone) and formatted in ISO 8601.
By default, start_date and end_date are set to +/- 2 weeks.
Only one of the equity identifiers (bloomberg_ticker, isin, permid, ric, or ticker) should be used per request. Using multiple equity identifier query parameters will end up resolving only one of them.
You can only pull a maximum of 365 days worth of calendar data at a time (using start_date and end_date, or modified_since). You could extend this range to 730 days by filtering to specific equities using one of the supported identifiers (or the watchlist_id parameter).

Request

https://premium.aiera.com/api/calendar?start_date=2024-10-31&end_date=2024-10-31&bloomberg_ticker=AMZN:US

Response

{
  "params": {
    "start_date": "2024-10-31T00:00:00",
    "end_date": "2024-10-31T23:59:59.999999",
    "bloomberg_ticker": "AMZN:US",
    "size": 15000,
    "from_index": 0
  },
  "count": 1,
  "events": [
    {
      "event_id": 2646352,
      "event_title": "Q3 2024 Amazon.com Inc Earnings Call",
      "event_type": "earnings",
      "event_date": "2024-10-31T17:00:00",
      "equity": {
        "equity_id": 1,
        "local_ticker": "AMZN",
        "bloomberg_ticker": "AMZN:US",
        "ric": "AMZN.OQ",
        "permid": "4295905494",
        "isin": "US0231351067",
        "exchange_mic": "XNAS"
      },
      "has_unknown_time": false,
      "connection_expected": true,
      "broadcast_url": "https://events.q4inc.com/attendee/878809675",
      "replay_url": "https://events.q4inc.com/attendee/878809675",
      "conference_number": null,
      "conference_pin": null,
      "slides_url": "https://a.aiera.com/api/events/2646352/assets/slides_url",
      "slides_url_type": "confirmed",
      "press_url": "https://a.aiera.com/api/events/2646352/assets/press_url",
      "press_url_type": "estimated",
      "transcription_status": "published",
      "transcription_audio_url": "https://audio.aiera.com/api/events/2646352/audio?api_key=API_KEY",
      "status": "active",
      "created": "2024-10-18T14:43:56",
      "modified": "2024-11-01T03:00:21"
    }
  ]
}

Code Samples

Bash

curl --request GET \
  --url 'https://premium.aiera.com/api/calendar/' \
  --header 'X-API-Key: xxx'

Python

import requests
requests.request("GET", "https://premium.aiera.com/api/calendar/", headers={"X-API-Key": "xxx"})