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 '{
  "rp_entity_id": "4A6F00",
  "start_date": "2023-12-25",
  "end_date": "2023-12-25",
  "categories": [
    "earnings-call",
    "conference-call"
  ]
}'
{
  "results": {},
  "errors": [
    {
      "message": "<string>"
    }
  ],
  "pagination": {
    "cursor": "00000DexaRK4NT6t",
    "has_cursor": true
  },
  "metadata": {
    "request_id": "<string>",
    "timestamp": "<string>"
  }
}

Authorizations

​
X-API-KEY
string
header
required

Body

application/json
​
rp_entity_id
string[]
required

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)

Minimum length: 1
Examples:

"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', for 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', for example, '2025-09-03'.

​
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
​
errors
ErrorDetail · object[] | null
​
pagination
object | null

Common pagination response for endpoints that support pagination.

​
metadata
object | null