v3

latestOpenAPI 3.1.02026-07-26490368.4 KB

IR Events

Get a company's IR events (currently earnings events)

Lists the resources attached to a company's IR events — currently earnings events, with more event types to come. Rows that share a fiscal period belong to the same event: the interim/annual report(s), the slide deck, the press release, and — when a call was held — the transcript and audio recording.

get/v1/company/ir-events

Query parameters

apiKeystring

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

tickerstring

Company ticker, use with mic or alone for US tickers

Example:MSFT

Company ticker, use with mic or alone for US tickers

micCodestring

Company MIC, use with ticker

Example:XNAS

Company MIC, use with ticker

exchangestring

Company exchange code, use with ticker

Example:NASDAQ

Company exchange code, use with ticker

companyKeystring

Company key (alternative to ticker/micCode/exchange)

Example:NASDAQ_MSFT

Company key (alternative to ticker/micCode/exchange)

cusipstring

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP

Example:594918104

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP

isinstring

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN

Example:US5949181045

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN

figistring

FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.

Example:BBG000BPH459

FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.

cikstring

Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.

Example:789019

Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.

fsclstring

Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.

Example:FSCLC6CGT4DXS597

Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.

Response

An array of IR event resources

eventTypestring required

The IR event type. Currently only 'earnings'.

eventDatestring

The event date (call date when known).

fiscalYearinteger

Fiscal year of the event.

fiscalQuarterinteger

Fiscal quarter (annual report = 4).

resourceType'document' | 'transcript' | 'audio' required

The type of resource attached to the event.

rolestring required

resourceIdstring required

For documents: the filing_id — resolve the PDF via /v1/filing/{filing_id}/pdf. For transcript/audio: the event key.

urlstring required

The fiscal.ai URL that serves this resource.

Example response

[
  {
    "eventType": "earnings",
    "eventDate": "2026-04-29",
    "fiscalYear": 2026,
    "fiscalQuarter": 3,
    "resourceType": "document",
    "role": "slide_deck",
    "resourceId": "0000000849-26-32024663",
    "url": "https://api.fiscal.ai/v1/filing/0000000849-26-32024663/pdf?companyKey=NASDAQ_MSFT"
  }
]