FIfiscal
Events Calendar

Get past and upcoming company events

Changed on

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. Keys without Events Calendar access, free-trial keys included, are served only the free-trial companies, under the free-trial rate limits.

get/v1/events-calendar

Request

  • Base URL
    https://api.fiscal.ai (the document declares no server; this is the origin it was published from)
  • URL
    https://api.fiscal.ai/v1/events-calendar
  • Auth
    • API key in query parameter apiKey
    • or API key in header X-Api-Key

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
companyKeystring

One or more comma-separated company keys.

Example:NASDAQ_AAPL
tickerstring

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

Example:AAPL
exchangestring

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

Example:NASDAQ
micCodestring

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

Example:XNAS
cusipstring

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

Example:037833100
isinstring

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

Example:US0378331005
figistring

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

Example:BBG000B9XRY4
cikstring

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

Example:0000320193
countrystring

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

Example:US
sectorstring

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

Example:Information Technology
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
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
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
pageinteger

1-based page number. Requires pageSize.

Example:1
pageSizeinteger

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

Example:250

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
  }
}

Changes