---
title: "Events Calendar"
method: POST
path: "/v1/events-calendar/query"
tags: ["Company & Events"]
---

# Events Calendar

`POST /v1/events-calendar/query`

A financial data API that, given a list of company identifiers, returns details of
key corporate events—such as earnings calls, and conference calls—allowing investors
and analysts to track upcoming and historical company announcements in real time.

## Request body

- EventsCalendarQuery
  - `rp_entity_id` string[], nullable — 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)
  - `start_date` string, date, nullable — 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'.
  - `end_date` string, date, nullable — 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'.
  - `countries` string[], nullable — A list of country codes (ISO 3166-1 alpha-2) to filter events by country. If omitted, events from all countries will be returned.
  - `exchanges` string[], nullable — The `exchange` field must contain a valid Market Identifier Code (MIC) corresponding to the exchange where the instrument is listed.
  - `categories` AllowedCategories[], nullable — A list of event categories to filter by. If omitted, all event types will be returned. Events covered: 'earnings-call', 'conference-call'.
  - `cursor` string, nullable — The cursor for pagination. Use the 'cursor' value from the previous response's pagination to get the next set of results.
  - `limit` integer, nullable — The number of results to return per page. Must be between 1 and 1000, both inclusive.

## Response `200`

Successful Response

- EventsCalendarResponse
  - `results` object, required — A dictionary mapping RP entity IDs to lists of event calendar entries for each company.
  - `errors` ErrorDetail[], nullable
    - `message` string, nullable
  - `metadata` Metadata
    - `request_id` string, required
    - `timestamp` string
  - `pagination` unknown

---

[API](https://skmtc.net/bigdata/apis/bigdata-structured-data-api.md) · [All operations](https://skmtc.net/bigdata/apis/bigdata-structured-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bigdata/bigdata-structured-data-api/versions/18082de268c4/schema)