> ## Documentation Index > Fetch the complete documentation index at: https://docs.bigdata.com/llms.txt > Use this file to discover all available pages before exploring further. # 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. ## OpenAPI ````yaml /api-rest/openapi/openapi_structured_data.json post /v1/events-calendar/query openapi: 3.1.0 info: title: Bigdata Structured Data API description: Bigdata API documentation version: 1.0.0 servers: - url: https://api.bigdata.com/ security: - ApiKeyAuth: [] tags: - name: Market Data description: >- Market data endpoints including intraday prices, daily prices, price changes, and real-time quotes - name: Analyst Estimates description: >- Analyst estimates and ratings including analyst ratings, estimates, target prices, and earnings surprises - name: Financials & Ratios description: >- Financial statements and ratios including balance sheet, income statement, cash flow statement, key metrics TTM, and company ratios TTM - name: Company & Events description: >- Company information and events including company profile and events calendar - name: Fund Holdings description: >- Institutional fund holdings from SEC 13F filings including fund holdings and stock fund holdings - name: Knowledge Graph description: Corporate ownership and hierarchy data. paths: /v1/events-calendar/query: post: tags: - Company & Events summary: Events Calendar description: >- 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. operationId: query_events_calendar_v1_events_calendar_query_post requestBody: content: application/json: schema: $ref: '#/components/schemas/EventsCalendarQuery' required: true responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/EventsCalendarResponse' components: schemas: EventsCalendarQuery: properties: rp_entity_id: anyOf: - items: type: string type: array - type: string - type: 'null' title: Rp Entity Id description: >- 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: anyOf: - type: string format: date - type: 'null' title: Start Date description: >- 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: anyOf: - type: string format: date - type: 'null' title: End Date description: >- 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: anyOf: - items: type: string type: array - type: string - type: 'null' title: Countries description: >- 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. examples: - US - GB exchanges: anyOf: - items: type: string type: array - type: 'null' title: Exchanges description: >- 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. examples: - XNYS - XNCM - XNGS categories: anyOf: - items: $ref: '#/components/schemas/AllowedCategories' type: array - type: 'null' title: Categories description: >- 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. examples: - earnings-call - conference-call - ipos-calendar cursor: anyOf: - type: string - type: 'null' title: Cursor description: >- The cursor for pagination. Use the 'cursor' value from the previous response's pagination to get the next set of results. examples: - '375207' limit: anyOf: - type: integer maximum: 1000 minimum: 1 - type: 'null' title: Limit description: >- 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. examples: - 100 type: object title: EventsCalendarQuery example: categories: - earnings-call - conference-call - ipos-calendar end_date: '2024-02-15' start_date: '2024-01-01' EventsCalendarResponse: properties: results: additionalProperties: items: $ref: '#/components/schemas/EventCalendar' type: array type: object title: Results description: >- 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. errors: anyOf: - items: $ref: '#/components/schemas/ErrorDetail' type: array - type: 'null' title: Errors metadata: anyOf: - $ref: '#/components/schemas/Metadata' - type: 'null' pagination: anyOf: - $ref: '#/components/schemas/Pagination' - type: 'null' events_unmapped: anyOf: - items: $ref: '#/components/schemas/EventCalendar' type: array - type: 'null' title: Events Unmapped description: >- 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'. type: object required: - results title: EventsCalendarResponse example: 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' AllowedCategories: type: string enum: - earnings-call - conference-call - ipos-calendar title: AllowedCategories EventCalendar: properties: category: type: string title: Category description: >- The category of the event, such as 'earnings-call' or 'conference-call'. examples: - earnings-call event_datetime: anyOf: - type: string format: date-time - type: 'null' title: Event Datetime description: >- The date and time of the event in ISO 8601 format (e.g., '2023-12-05T20:00:00Z'). Events whose source dates them to the day rather than to the minute, such as IPO listings, are reported at midnight UTC on that date. examples: - '2024-01-25T21:00:00Z' title: type: string title: Title description: >- The title of the event, which provides a brief description of the event's content. examples: - Alphabet Inc. Q4 2023 Earnings Call fiscal_year: anyOf: - type: integer - type: 'null' title: Fiscal Year description: The fiscal year of the event. examples: - 2023 fiscal_period: anyOf: - type: string - type: 'null' title: Fiscal Period description: The fiscal period of the event, such as 'Q1', 'Q2', etc. examples: - Q4 rp_collection_id: anyOf: - type: string - type: 'null' title: Rp Collection Id description: >- The RP collection id. All RP documents can be fetched using this id. Absent for events with no document behind them, such as IPO listings. examples: - 20c4436bf8627400ad58f73dde7f2a6f updated_at: anyOf: - type: string format: date-time - type: 'null' title: Updated At description: >- The date and time when the event data was last updated, in ISO 8601 format (e.g., '2024-02-27T09:35:45Z'). examples: - '2024-01-20T14:30:15Z' created_at: anyOf: - type: string format: date-time - type: 'null' title: Created At description: >- The date and time when the event data was created, in ISO 8601 format (e.g., '2023-11-15T08:14:26Z'). examples: - '2023-11-15T08:14:26Z' ticker: anyOf: - type: string - type: 'null' title: Ticker description: The ticker the offering will list under. IPO listings only. examples: - RBLX company_name: anyOf: - type: string - type: 'null' title: Company Name description: The company name as the source reports it. IPO listings only examples: - Roblox Corporation exchange: anyOf: - type: string - type: 'null' title: Exchange description: >- The exchange the offering will list on, as the source names it (e.g. 'NASDAQ'). IPO listings only. This is the source's own name, not a MIC code, and IPO listings cannot be filtered by exchange at all: setting the 'exchanges' request filter excludes the 'ipos-calendar' category from the response. examples: - NYSE type: object required: - category - title title: EventCalendar ErrorDetail: properties: message: anyOf: - type: string - type: 'null' title: Message type: object title: ErrorDetail Metadata: properties: request_id: type: string title: Request Id timestamp: type: string title: Timestamp type: object required: - request_id title: Metadata Pagination: properties: cursor: anyOf: - type: string - type: 'null' title: Cursor description: Next page token or URL to retrieve the next page of results. examples: - 00000DexaRK4NT6t has_cursor: type: boolean title: Has Cursor description: Whether there are more pages available after this one. default: false examples: - true type: object title: Pagination description: Common pagination response for endpoints that support pagination. securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-KEY ````