Retrieve an earnings call

Return one earnings-call transcript for a company and fiscal period. Pass a company identifier such as NASDAQ:AAPL together with the fiscal year and quarter the call reports on.

GET/v3.0.0/earnings-calls/{identifier}

Plan Access

Free

(Your plan)

Individual

$29/mo

Professional

$89/mo

Plan History

Free

(Your plan)

2 quarters

Individual

$29/mo

20 quarters

Professional

$89/mo

All available quarters

Request
curl "https://api.roic.ai/v3.0.0/earnings-calls/NASDAQ:AAPL?apikey=YOUR_API_KEY&fiscal_year=2026&fiscal_quarter=2&format=json"
Response
200 OK
{
  "id": "ecall_Jk8mN2pQ4rS6tV",
  "object": "v3.content.earnings_call_transcript",
  "symbol": "NASDAQ:AAPL",
  "fiscal_year": 2026,
  "fiscal_quarter": 2,
  "date": "2026-05-01",
  "transcript": [
    {
      "speaker": "Operator",
      "text": "Good day, and welcome to the Apple Q2 fiscal year 2026 earnings conference call."
    },
    {
      "speaker": "Tim Cook",
      "text": "Thank you. Today Apple is reporting another strong quarter, with revenue growth across every geographic segment."
    },
    {
      "speaker": "Luca Maestri",
      "text": "Revenue for the quarter was a March-quarter record, and we returned over $27 billion to shareholders."
    },
    {
      "speaker": "Analyst - Morgan Stanley",
      "text": "Thanks for taking my question. Can you talk about Services momentum heading into the second half?"
    }
  ]
}

Parameters

Path parameters

identifierstringrequired

Company identifier: an exchange and symbol separated by a colon (e.g. NASDAQ:AAPL), a ticker ID, or a FIGI.

Example: NASDAQ:AAPL

Query parameters

fiscal_yearintegerrequired

The fiscal year the call reports on.

Example: 2026
fiscal_quarterintegerrequired

The fiscal quarter the call reports on, from 1 to 4.

Example: 2Min: 1Max: 4
formatstringoptional

Transcript representation.

Default: jsonValues: jsontext

Response

Response fields

idstring

Unique identifier for the earnings call, beginning with ecall_. Use it as a stable reference in your own records; the retrieve endpoint takes a company identifier with fiscal_year and fiscal_quarter, not this ID.

objectstring

String representing the object's type. List items are v3.content.earnings_call, while the retrieve endpoint returns a v3.content.earnings_call_transcript resource that adds the transcript.

symbolstring

Qualified symbol combining the exchange code and ticker separated by a colon, e.g. NASDAQ:AAPL. When you filter the list by identifier, this echoes the listing you requested.

fiscal_yearnumber

Fiscal year the call reports on, e.g. 2026. Fiscal years may not align with calendar years.

fiscal_quarternumber

Fiscal quarter the call reports on, from 1 to 4.

datestring

UTC calendar date the call took place, in YYYY-MM-DD format. null when the call's date is not known.

transcriptarray of objects

Array of speaker turns in chronological order. Returned only by the retrieve endpoint with format=json. List items omit it to keep responses small.

+ Show child attributes
speakerstring

Name or role of the person speaking in this turn, e.g. Tim Cook, Operator, or Analyst - Morgan Stanley. May be null when the speaker cannot be identified, though most turns carry a real name.

textstring

Verbatim text spoken during this turn.

Related endpoints

Use the list route to discover which fiscal periods have calls available.