Estimated events

Fetch estimated events by ticker, date range, etc.

GET /calendar-v2/estimated

Parameter	Type	DataType	Description
start_date	query	datetime	Fetch events on or after this date (defaults to today)
end_date	query	datetime	Fetch events on or before this date (defaults to 26 weeks from now)
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 events to one or more PermIDs (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 tickers (comma-separated)
event_ids	query	string	Filter events to one or more event IDs (comma-separated)
page	query	integer	The page of results to return
page_size	query	integer	The size of pages to return (default: 100, max: 2500)

NOTE

All dates are in Eastern Time (America/New_York timezone) and formatted in ISO 8601
Only one of the equity identifiers (bloomberg_ticker, isin, ric, permid, or ticker) should be used per request. Using multiple equity identifier query parameters will end up resolving only one of them.

Request

https://premium.aiera.com/api/events-v2/estimated?bloomberg_ticker=AMZN:US

Response

{
    "params": {
        "start_date": "2025-08-27T15:06:27.138791",
        "end_date": "2026-02-25T15:06:27.138824",
        "bloomberg_ticker": "AMZN:US"
    },
    "pagination": {
        "total_count": 3,
        "current_page": 1,
        "total_pages": 1,
        "page_size": 3
    },
    "results": [
        {
            "estimate_id": 18807,
            "equity": {
                "equity_id": 1,
                "name": "AMAZON COM INC",
                "common_name": "AMAZON COM INC",
                "local_ticker": "AMZN",
                "mic": "XNAS",
                "bloomberg_ticker": "AMZN:US",
                "isin": "US0231351067",
                "permid": "4295905494",
                "gics_sector": "Consumer Discretionary",
                "gics_sub_sector": "Broadline Retail"
            },
            "estimate": {
                "call_type": "earnings",
                "call_date": "2025-10-23T17:30:00",
                "title": "Q3 Earnings Call"
            },
            "actual": {
                "event_id": 12345,
                "call_type": "earnings",
                "call_date": "2025-10-24T18:05:00",
                "title": "Amazon Q3 2025 Earnings Call"
            }
        },
        {
            "estimate_id": 18809,
            "equity": {
                "equity_id": 1,
                "name": "AMAZON COM INC",
                "common_name": "AMAZON COM INC",
                "local_ticker": "AMZN",
                "mic": "XNAS",
                "bloomberg_ticker": "AMZN:US",
                "isin": "US0231351067",
                "permid": "4295905494",
                "gics_sector": "Consumer Discretionary",
                "gics_sub_sector": "Broadline Retail"
            },
            "estimate": {
                "call_type": "presentation",
                "call_date": "2025-11-29T11:00:00",
                "title": "Amazon.com Inc at re:Invent"
            },
            "actual": null
        },
        {
            "estimate_id": 18803,
            "equity": {
                "equity_id": 1,
                "name": "AMAZON COM INC",
                "common_name": "AMAZON COM INC",
                "local_ticker": "AMZN",
                "mic": "XNAS",
                "bloomberg_ticker": "AMZN:US",
                "isin": "US0231351067",
                "permid": "4295905494",
                "gics_sector": "Consumer Discretionary",
                "gics_sub_sector": "Broadline Retail"
            },
            "estimate": {
                "call_type": "earnings",
                "call_date": "2026-02-05T17:30:00",
                "title": "Q4 Earnings Call"
            },
            "actual": null
        }
    ]
}

Code Samples

Bash

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

Python

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