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)
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, min: 10, max: 100)

NOTE

Access to this endpoint requires explicit permissions to be enabled on your API key. If you receive a 403 error or empty results, contact your Aiera account team to have estimated events access activated.
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, or permid) should be used per request. Using multiple equity identifier query parameters will end up resolving only one of them.
Each result includes created and modified timestamps (Eastern Time, ISO 8601) indicating when the estimate was first created and last updated.
The equity schema in this endpoint uses gics_sub_sector (with underscore). Note that this differs from the /calendar-v2/coverage endpoint, which uses gics_subsector (no underscore).

Request

https://premium.aiera.com/api/calendar-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,
            "created": "2025-07-15T10:30:00",
            "modified": "2025-08-20T14:22:11",
            "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,
            "created": "2025-07-15T10:30:00",
            "modified": "2025-08-20T14:22:11",
            "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,
            "created": "2025-07-15T10:30:00",
            "modified": "2025-08-20T14:22:11",
            "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"})