Skip to main content
POST
/
v1
/
events-calendar
/
query
Events Calendar
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"
  ],
  "end_date": "2024-02-15",
  "limit": 100,
  "rp_entity_id": [
    "4A6F00",
    "D8442A"
  ],
  "start_date": "2024-01-01"
}'
{
  "results": {
    "4A6F00": [
      {
        "category": "earnings-call",
        "created_at": "2023-11-15T08:14:26.000Z",
        "event_datetime": "2024-01-25T21:00:00.000Z",
        "fiscal_period": "Q4",
        "fiscal_year": 2023,
        "rp_collection_id": "RP_COLLECTION_123456789",
        "title": "Alphabet Inc. Q4 2023 Earnings Call",
        "updated_at": "2024-01-20T14:30:15.000Z"
      },
      {
        "category": "conference-call",
        "created_at": "2024-01-05T12:00:00.000Z",
        "event_datetime": "2024-02-15T16:00:00.000Z",
        "fiscal_year": 2024,
        "rp_collection_id": "RP_COLLECTION_987654321",
        "title": "Alphabet Inc. Investor Day 2024",
        "updated_at": "2024-02-10T09:15:30.000Z"
      }
    ],
    "D8442A": [
      {
        "category": "earnings-call",
        "created_at": "2023-12-20T10:30:45.000Z",
        "event_datetime": "2024-01-31T17:00:00.000Z",
        "fiscal_period": "Q1",
        "fiscal_year": 2024,
        "rp_collection_id": "RP_COLLECTION_456789123",
        "title": "Apple Inc. Q1 2024 Earnings Call",
        "updated_at": "2024-01-25T11:45:20.000Z"
      }
    ]
  }
}

Authorizations

X-API-KEY
string
header
required

Body

application/json
rp_entity_id
string[] | null

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)

Examples:

"4A6F00"

"D8442A"

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'.

Examples:

"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'.

Examples:

"2025-09-03"

countries
string[] | null

A list of country codes (ISO 3166-1 alpha-2) to filter events by country. If omitted, events from all countries will be returned.

Examples:

"US"

"GB"

exchanges
string[] | null

The exchange field must contain a valid Market Identifier Code (MIC) corresponding to the exchange where the instrument is listed.

Examples:

"XNAS"

"NYSE"

"XSCA"

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'.

Examples:

"earnings-call"

"conference-call"

Response

200 - application/json

Successful Response

results
object
required

A dictionary mapping RP entity IDs to lists of event calendar entries for each company.

errors
ErrorDetail · object[] | null
metadata
object | null