v3

latestOpenAPI 3.1.02026-07-26490368.4 KB

Events Calendar

Get past and upcoming company events

Returns company earnings events. Omit company identifiers to retrieve the global calendar, or provide one or more comma-separated identifiers of a single type to filter the calendar by company. Results are sorted by eventDate in ascending order. Use page and pageSize to paginate large result sets.

get/v1/events-calendar

Query parameters

apiKeystring

API Key (alternatively send via X-Api-Key header)

fsclstring

One or more comma-separated Fiscal.ai company, listing, or security identifiers (FSCLC, FSCLL, or FSCLS); each resolves to its canonical company.

Example:FSCLC4VNY8NEQ478

One or more comma-separated Fiscal.ai company, listing, or security identifiers (FSCLC, FSCLL, or FSCLS); each resolves to its canonical company.

companyKeystring

One or more comma-separated company keys.

Example:NASDAQ_AAPL

One or more comma-separated company keys.

tickerstring

One or more comma-separated company tickers. Use alone for US tickers, or pair with exchange or micCode.

Example:AAPL

One or more comma-separated company tickers. Use alone for US tickers, or pair with exchange or micCode.

exchangestring

Exchange code used with ticker. Supply one value for all tickers or a comma-separated value for each ticker.

Example:NASDAQ

Exchange code used with ticker. Supply one value for all tickers or a comma-separated value for each ticker.

micCodestring

MIC used with ticker. Supply one value for all tickers or a comma-separated value for each ticker.

Example:XNAS

MIC used with ticker. Supply one value for all tickers or a comma-separated value for each ticker.

cusipstring

One or more comma-separated CUSIPs. Requires the CUSIP/ISIN license.

Example:037833100

One or more comma-separated CUSIPs. Requires the CUSIP/ISIN license.

isinstring

One or more comma-separated ISINs. Requires the CUSIP/ISIN license.

Example:US0378331005

One or more comma-separated ISINs. Requires the CUSIP/ISIN license.

figistring

One or more comma-separated Financial Instrument Global Identifiers (FIGIs).

Example:BBG000B9XRY4

One or more comma-separated Financial Instrument Global Identifiers (FIGIs).

cikstring

One or more comma-separated SEC Central Index Keys (CIKs).

Example:0000320193

One or more comma-separated SEC Central Index Keys (CIKs).

countrystring

Filter by ISO country code of the company's headquarters (case-insensitive, e.g. US, GB).

Example:US

Filter by ISO country code of the company's headquarters (case-insensitive, e.g. US, GB).

sectorstring

Filter by GICS sector (case-insensitive exact match).

Example:Information Technology

Filter by GICS sector (case-insensitive exact match).

startDatestring date

Inclusive lower bound (YYYY-MM-DD). Non-projected events compare eventDate; projected events match when dateWindow overlaps the requested range.

Example:2026-05-01

Inclusive lower bound (YYYY-MM-DD). Non-projected events compare eventDate; projected events match when dateWindow overlaps the requested range.

endDatestring date

Inclusive upper bound (YYYY-MM-DD). Non-projected events compare eventDate; projected events match when dateWindow overlaps the requested range.

Example:2026-05-31

Inclusive upper bound (YYYY-MM-DD). Non-projected events compare eventDate; projected events match when dateWindow overlaps the requested range.

status'confirmed' | 'estimated' | 'projected' | 'reported'

Filter by event status: confirmed (company-stated date), estimated (source-derived specific date), projected (cadence-derived window), or reported (occurred).

Example:confirmed

Filter by event status: confirmed (company-stated date), estimated (source-derived specific date), projected (cadence-derived window), or reported (occurred).

pageinteger

1-based page number. Requires pageSize.

Example:1

1-based page number. Requires pageSize.

pageSizeinteger

Page size (1-1000). Without it, a result over 1000 rows is rejected — paginate or narrow filters.

Example:250

Page size (1-1000). Without it, a result over 1000 rows is rejected — paginate or narrow filters.

Response

Object containing a data array of company events plus pagination meta

Example response

{
  "data": [
    {
      "companyFiscalIdentifier": "FSCLC4VNY8NEQ478",
      "companyKey": "NASDAQ_AAPL",
      "displayNameEnglish": "Apple Inc.",
      "sector": "Information Technology",
      "headquartersCountryCode": "US",
      "marketCapUsd": 4618730000000,
      "primaryListing": {
        "ticker": "AAPL",
        "exchangeCode": "NASDAQ",
        "exchangeName": "Nasdaq Stock Market",
        "operatingMic": "XNAS"
      },
      "eventType": "earnings",
      "eventRole": "financial_results_release",
      "title": "Q3 2026 Earnings Release",
      "fiscalYear": 2026,
      "fiscalQuarter": 3,
      "periodLabel": "Q3 2026",
      "periodType": "quarterly",
      "periodDuration": {
        "amount": 3,
        "unit": "month"
      },
      "reportDate": "2026-06-27",
      "eventStatus": "confirmed",
      "eventDate": "2026-07-30",
      "dateWindow": null,
      "eventSession": "after_close",
      "eventTime": null,
      "eventTimezone": null,
      "eventDatetimeUtc": null,
      "eventId": "46e66399b9e63243",
      "eventGroupId": "c1b017a1dea50848"
    },
    {
      "companyFiscalIdentifier": "FSCLC4VNY8NEQ478",
      "companyKey": "NASDAQ_AAPL",
      "displayNameEnglish": "Apple Inc.",
      "sector": "Information Technology",
      "headquartersCountryCode": "US",
      "marketCapUsd": 4618730000000,
      "primaryListing": {
        "ticker": "AAPL",
        "exchangeCode": "NASDAQ",
        "exchangeName": "Nasdaq Stock Market",
        "operatingMic": "XNAS"
      },
      "eventType": "earnings",
      "eventRole": "earnings_call_for_results",
      "title": "Q3 2026 Earnings Call",
      "fiscalYear": 2026,
      "fiscalQuarter": 3,
      "periodLabel": "Q3 2026",
      "periodType": "quarterly",
      "periodDuration": {
        "amount": 3,
        "unit": "month"
      },
      "reportDate": "2026-06-27",
      "eventStatus": "confirmed",
      "eventDate": "2026-07-30",
      "dateWindow": null,
      "eventSession": "after_close",
      "eventTime": "14:00:00",
      "eventTimezone": "America/Los_Angeles",
      "eventDatetimeUtc": "2026-07-30T21:00:00Z",
      "eventId": "85339f8b8a082040",
      "eventGroupId": "c1b017a1dea50848"
    }
  ],
  "meta": {
    "page": 1,
    "pageSize": 2,
    "totalCount": 2,
    "returnedCount": 2,
    "hasMore": false
  }
}