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

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/company/ir-events
Auth
API key in query parameter apiKey

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

micCodestring

Company MIC, use with ticker

Example:XNAS

exchangestring

Company exchange code, use with ticker

Example:NASDAQ

companyKeystring

Company key (alternative to ticker/micCode/exchange)

Example:NASDAQ_MSFT

cusipstring

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

Example:594918104

isinstring

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

Example:US5949181045

figistring

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

Example:BBG000BPH459

cikstring

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

Example:789019

fsclstring

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

Example:FSCLC6CGT4DXS597

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

Changes

No recorded changes to this operation across all 24 revisions of this API.