EarningsCalls

The earnings-call event for a fiscal quarter — the record grouping the quarter's call artefacts (audio, transcript, slide deck, 8-K earnings release), with the release's extracted guidance rows when approved ones exist.

Changed on
get/v1/stocks/{ticker}/earnings-calls/{fiscalYear}/{fiscalQuarter}

Request

Path parameters

tickerstring required

Company ticker symbol (e.g. AAPL), or MIC:TICKER for a company listed on another exchange (e.g. XLIS:NOS).

fiscalYearinteger required

Fiscal year the quarter belongs to (e.g. 2025).

fiscalQuarterinteger required

Fiscal quarter, 1-4.

Response

OK

tickerstring nullable
companyNamestring nullable
guidanceStatusstring nullable

Why guidance is (or is not) populated: "approved" when a verifier-approved extraction backs the rows (an empty list then means the release genuinely guided nothing), "notExtracted" when the release exists but no approved extraction does yet, null when no 8-K earnings release is linked to the event.

liveTranscriptStatestring nullable

Present while the call has preliminary live text and no speaker-labelled transcript yet: "live" while it is being recorded, "ended" once the recording finished, "endedEarly" when our capture stopped before the call did. Read the text from the live-transcript endpoint. Omitted otherwise.

idstring uuid
eventTypestring nullable
eventTypeNamestring nullable
titlestring nullable
callDatestring date-time
callDateIsPeriodEndboolean

True when callDate is only the end of the call's fiscal quarter, held until the real call date is known; treat the call date as not confirmed. Always false for events other than earnings calls.

fiscalYearinteger nullable
fiscalQuarterinteger nullable
statusstring nullable
statusNamestring nullable
webcastUrlstring nullable
transcriptDocumentIdstring uuid nullable
earningsReleaseDocumentIdstring uuid nullable
hasAudioboolean
hasSlidesboolean
hasTranscriptboolean

Whether a speaker-labelled transcript is available via the speakers endpoints. Broader than transcriptDocumentId: an audio-pipeline transcription stores speaker turns without a transcript document, so gate on this flag, not the document id.

isTombstonedboolean nullable

True on an event hidden by default because none of its materials could be captured; only includeUncaptured=true returns one. Omitted otherwise.

presentationOnlyboolean nullable

True when the audio and transcript are the company's presentation only: the company published no recording of the Q&A. Omitted otherwise.

partialRecordingboolean nullable

True when the audio and transcript come from a live recording that joined the call after it began: the opening is missing until the company's replay replaces them. Omitted otherwise.

Changes

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status