Get calendar

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

GET /calendar-v2/

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
page	query	integer	The page of results to return
page_size	query	integer	The size of pages to return (default: 100, max: 2500)

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-v2?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",
        "page_size": 100,
        "from_index": 0
    },
    "pagination": {
        "total_count": 1,
        "current_page": 1,
        "total_pages": 1,
        "page_size": 1
    },
    "data": [
        {
            "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",
            "press_url": "https://a.aiera.com/api/events/2646352/assets/press_url",
            "transcription_status": "published",
            "transcription_audio_url": "https://audio.aiera.com/api/events/2646352/audio",
            "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-v2' \
  --header 'X-API-Key: xxx'

Python

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