Events Calendar

A financial data API that returns details of key corporate events, such as earnings calls, conference calls, US IPO listings, and US delistings. Query by a specific list of companies, by date range alone, or both, allowing investors and analysts to track upcoming and historical company announcements in real time.

POST /v1/events-calendar/query

Events Calendar

cURL

curl --request POST \
  --url https://api.bigdata.com/v1/events-calendar/query \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "categories": [
    "earnings-call",
    "conference-call",
    "ipos-calendar",
    "delisted-company"
  ],
  "end_date": "2026-02-15",
  "start_date": "2026-01-01"
}
'

200

{
  "events_unmapped": [
    {
      "category": "ipos-calendar",
      "company_name": "AppMedia Inc.",
      "event_datetime": "2024-02-01T00:00:00Z",
      "exchange": "NASDAQ",
      "ticker": "APMD",
      "title": "AppMedia Inc. (APMD) Set to List on NASDAQ on 2024-02-01"
    }
  ],
  "pagination": {
    "cursor": "375207",
    "has_cursor": true
  },
  "results": {
    "4A6F00": [
      {
        "category": "earnings-call",
        "created_at": "2023-11-15T08:14:26Z",
        "event_datetime": "2024-01-25T21:00:00Z",
        "fiscal_period": "Q4",
        "fiscal_year": 2023,
        "rp_collection_id": "20c4436bf8627400ad58f73dde7f2a6f",
        "title": "Alphabet Inc. Q4 2023 Earnings Call",
        "updated_at": "2024-01-20T14:30:15Z"
      },
      {
        "category": "conference-call",
        "created_at": "2024-01-05T12:00:00Z",
        "event_datetime": "2024-02-15T16:00:00Z",
        "fiscal_year": 2024,
        "rp_collection_id": "e25cae2fa959ff596c54ee5589de2f9b",
        "title": "Alphabet Inc. Investor Day 2024",
        "updated_at": "2024-02-10T09:15:30Z"
      }
    ],
    "D8442A": [
      {
        "category": "earnings-call",
        "created_at": "2023-12-20T10:30:45Z",
        "event_datetime": "2024-01-31T17:00:00Z",
        "fiscal_period": "Q1",
        "fiscal_year": 2024,
        "rp_collection_id": "cda8c9e70e436107b6bae880e1c80603",
        "title": "Apple Inc. Q1 2024 Earnings Call",
        "updated_at": "2024-01-25T11:45:20Z"
      }
    ]
  }
}

Authorizations

X-API-KEY · string · header · required

Body

application/json

rp_entity_id · string[] string

A list of RavenPack internal entity identifiers. Bigdata uses the RavenPack Entity identifier (RP_Entity_ID) to uniquely reference entities such as companies. This identifier is a 6-character alphanumeric code (letters and numbers only). Example: Alphabet Inc. (4A6F00)

Example:

"4A6F00"

start_date · string<date> | null

The start date of the time range for retrieving events. Only events occurring on or after this date will be included. The expected date format is 'YYYY-MM-DD'.

Example:

"2025-09-02"

end_date · string<date> | null

The end date of the time range for retrieving events. Only events occurring on or before this date will be included. The expected date format is 'YYYY-MM-DD'.

Example:

"2025-09-03"

countries · string[] string

A list of country codes (ISO 3166-1 alpha-2) to filter events by country. If omitted, events from all countries will be returned. The IPO and delisted calendars cover US companies only, so 'ipos-calendar' and 'delisted-company' events are included when the country list is omitted or empty, or when 'US' is included in the list.

Example:

"US"

exchanges · string[] | null

Exchange code(s) to filter events by. Accepts MIC codes (ISO 10383, e.g. 'XNYS', 'XNGS'). Accepts a single exchange or a list. Setting this filter excludes 'ipos-calendar' and 'delisted-company' events from the response entirely - both report exchanges as free text rather than MIC codes, so neither can honour the filter.

Example:

"XNYS"

categories · enum<string>[] | null

A list of event categories to filter by. Events covered: 'earnings-call', 'conference-call', 'ipos-calendar', 'delisted-company'. IPO listings and delistings are US-only, and the 'cursor' and 'exchanges' filters do not apply to either. If omitted, every category your organization has access to is returned. Note that every delisting is in the past, so a forward-looking window matches none of them. 'delisted-company' covers delistings from 2025-01-01 onwards; naming it with an 'end_date' before that returns 422 rather than an empty calendar, and naming it without a 'start_date' returns every delisting from 2025-01-01 to your 'end_date'. Set 'start_date' to narrow that. Access to 'ipos-calendar' and 'delisted-company' is enabled per organization. A category your organization does not have is left out of the response and the rest of the request is served; a request left with no category to serve returns 403.

Available options: earnings-call, conference-call, ipos-calendar, delisted-company

Example:

"earnings-call"

cursor · string | null

The cursor for pagination. Use the 'cursor' value from the previous response's pagination to get the next set of results.

Example:

"375207"

limit · integer | null

The number of results to return per page. Must be between 1 and 500, both inclusive. It bounds the transcript events a page pages through; IPO listings are returned alongside them, so a page can carry more events than the limit.

Required range: 1 <= x <= 500

Example:

100

Response

200 - application/json

Successful Response

results · Results · object · required

A dictionary mapping RP entity IDs to lists of event calendar entries for each company. Only events whose company has an rp_entity_id appear here; the rest are in 'events_unmapped', so read both to get the whole calendar.

Show child attributes

errors · ErrorDetail · object[] | null

Show child attributes

metadata · Metadata · object | null

Show child attributes

pagination · Pagination · object | null

Common pagination response for endpoints that support pagination.

Show child attributes

events_unmapped · EventCalendar · object[] | null

Events whose company has not been mapped to an rp_entity_id appear here instead of in 'results'. For an IPO listing this reflects a temporary state in the mapping process: once the company begins trading and mapping completes, the event moves into 'results'. A delisted company may instead never have been mapped. Identify these events by 'ticker' and 'company_name'.

Show child attributes

sources · Source · object[]

The content catalog sources the response was built from, one entry per source. Empty when no catalog source contributed.

Show child attributes

usage · Usage · object | null

Tokens the request consumed, per content tier. Present only for API keys billed in tokens.

Show child attributes