Sign in

v1

latestOpenAPI 3.1.02026-07-2268276396.6 KB
Company & Events

Events Calendar

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.

post/v1/events-calendar/query

Request body

rp_entity_idstring[] 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_datestring 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_datestring 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'.

countriesstring[] 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.

exchangesstring[] nullable

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

categoriesAllowedCategories[] nullable

A list of event categories to filter by. If omitted, all event types will be returned. Events covered: 'earnings-call', 'conference-call'.

cursorstring nullable

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

limitinteger nullable

The number of results to return per page. Must be between 1 and 1000, both inclusive.

Example request

{
  "categories": [
    "earnings-call",
    "conference-call"
  ],
  "end_date": "2024-02-15",
  "limit": 100,
  "rp_entity_id": [
    "4A6F00",
    "D8442A"
  ],
  "start_date": "2024-01-01"
}

Response

Successful Response

resultsobject required

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

{"stackTrail":"components:schemas:EventsCalendarResponse:properties:pagination:anyOf","oasType":"schema","type":"unknown","nullable":true}

Example response

{
  "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"
      }
    ]
  },
  "pagination": {
    "cursor": "375207",
    "has_cursor": true
  }
}