Events Calendar

A financial data API that, given a list of company identifiers, returns details of key corporate events—such as earnings calls, conference calls, and US IPO listings—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"
  ],
  "end_date": "2024-02-15",
  "start_date": "2024-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 calendar covers US offerings only, so 'ipos-calendar' 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' events from the response entirely - the IPO calendar reports exchanges as free text rather than MIC codes, so it cannot honour the filter.

Example:

"XNYS"

categories · enum<string>[] | null

A list of event categories to filter by. If omitted, all event types will be returned. Events covered: 'earnings-call', 'conference-call', 'ipos-calendar'. IPO listings are US-only calendar.'cursor' 'exchanges' filters don't apply to ipos-calendar events. Access to 'ipos-calendar' 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

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 1000, 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 <= 1000

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 yet been mapped to an rp_entity_id appear here instead of in 'results'. This reflects a temporary state in the mapping process: once the company begins trading and mapping completes, the event moves into 'results'. Identify these events by 'ticker' and 'company_name'.

Show child attributes