EarningsCalls

The preliminary text of a fiscal quarter's earnings call while it is being recorded live, and until its speaker-labelled transcript is ready: numbered machine-transcribed lines without speaker labels, new ones about every 20 seconds. Pass after (the highest seq received) and run (the run received) to get only the lines since; final=true says the speaker-labelled transcript has replaced the text, state "none" that the call has no live text. The answer is never cached.

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

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.

Query parameters

afterinteger

The highest line seq already received (default -1, the whole text so far); only later lines are returned.

runstring

The run value of the previous response; a different run means the recording restarted and the full text is returned with reset=true.

Response

OK

eventIdstring uuid
tickerstring nullable
eventTitlestring nullable
callDatestring date-time
fiscalYearinteger nullable
fiscalQuarterinteger nullable
statestring nullable

"live" while the call is being recorded, "ended" once the recording finished and the speaker-labelled transcript is being prepared, "endedEarly" when our capture stopped before the call did, "none" when no live text exists for the call.

finalboolean

True once the speaker-labelled transcript exists: read it from the speakers endpoint and stop polling.

runstring nullable

Identifies the recording's numbering; pass it back as run. Null before the first line exists.

resetboolean

True when the lines you hold belong to an earlier numbering (the recording restarted): discard them and take data as the full text.

lastSeqinteger

The highest line number the recording holds so far, -1 before the first line; the value to pass as after on the next request.

lineCountinteger

Lines in this response: those after after, or every line on a reset or a first request.

nextPollSecondsinteger

How long to wait before asking again, in seconds; 0 means the text is final or no live capture can start.

Changes