Retrieve an edited transcript

The edited transcript returns one earnings call as segments in call order, each with a speaker_id, plus a speakers map that gives the name, role and company behind every id. Use it to separate prepared remarks from the analyst Q&A, attribute a statement to the CFO, or count how often each analyst spoke.

Take the tredit_ id from the transcripts array of the call listing. The edited version is based on the raw transcript, reviewed and edited by a human, and added once the speaker labels have been matched to the call. It requires a Professional or Enterprise plan.

GET/v3.0.0/documents/transcripts/{id}/edited

Plan Access

Free

(Your plan)

Individual

$29/mo

Professional

$89/mo

Plan History

Free

(Your plan)

Not included

Individual

$29/mo

Not included

Professional

$89/mo

All available

Request
curl "https://api.roic.ai/v3.0.0/documents/transcripts/tredit_hbBlbCUawzMoz0/edited?apikey=YOUR_API_KEY"
Response
200 OK
{
  "id": "tredit_hbBlbCUawzMoz0",
  "event": "evt_hbBlbCUawzMoz0",
  "symbol": "NASDAQ:AAPL",
  "fiscal_year": 2026,
  "fiscal_quarter": 3,
  "period_end_date": "2026-06-30",
  "language": "en",
  "created_at": "2026-08-03T03:41:12.085Z",
  "updated_at": "2026-08-04T09:03:55.085Z",
  "edition": "edited",
  "segments": [
    {
      "speaker_id": "speaker_0",
      "text": "Good afternoon and welcome to the Apple Q3 fiscal year 2026 earnings conference call. ..."
    },
    {
      "speaker_id": "speaker_1",
      "text": "Thank you, Suhasini. Good afternoon, everyone, and thanks for joining the call. ..."
    },
    {
      "speaker_id": "speaker_2",
      "text": "Thank you, Tim. Revenue for the June quarter was a record, and we returned over $27 billion to shareholders. ..."
    },
    {
      "speaker_id": "speaker_3",
      "text": "Our first question comes from the line of Michael Ng with Goldman Sachs. ..."
    }
  ],
  "speakers": {
    "speaker_0": {
      "name": "Suhasini Chandramouli",
      "role": "Director of Investor Relations",
      "company": "Apple"
    },
    "speaker_1": {
      "name": "Tim Cook",
      "role": "CEO",
      "company": "Apple"
    },
    "speaker_2": {
      "name": "Kevan Parekh",
      "role": "CFO",
      "company": "Apple"
    },
    "speaker_3": {
      "name": "Operator",
      "role": null,
      "company": null
    }
  }
}

Availability

The latest published calls, with how long after each call ended the raw and then the edited transcript went live.

1909
calls in the last 7 days
1h 12m
raw, median after the call
2h 46m
edited, median after the call
32%
edited within 24 hours
CompanyCall, UTCRawEdited
NSE:TTKPRESTIGTTK Prestige LimitedNov 6, 10:3044 min+44 minNov 6, 11:57Pending
NSE:SUDARSCHEMSudarshan Chemical Industries LimitedNov 6, 10:3058 min+37 minNov 6, 12:05Pending
STO:SEAFSeafire ABNov 6, 10:0036 min+51 minNov 6, 11:26Pending
STO:FRACTLFractal Gaming Group ABNov 6, 09:0038 min+1h 02mNov 6, 10:39Pending
STO:ATTAttendo ABNov 6, 09:0040 min+54 minNov 6, 10:34Pending
TPEX:8299Phison Electronics Corp.Nov 6, 09:0058 min+1h 31mNov 6, 11:29Pending
STO:CCCCavotec Group ABNov 6, 09:0027 min+38 minNov 6, 10:05Pending
CPH:SCHOSchouw & CoNov 6, 09:0033 min+54 minNov 6, 10:26Pending
EURONEXT:BPOSTbpost SANov 6, 09:0059 min+21 minNov 6, 10:19Pending
NSE:AJAXENGGAjax Engineering Ltd.Nov 6, 09:0054 min+1h 37mNov 6, 11:30Pending
STO:ARPLArla Plast ABNov 6, 09:0017 min+2h 42mNov 6, 11:58Pending
BME:LOGLogista Integral, S.A.Nov 6, 09:0044 min+2h 08mNov 6, 11:52+2h 08mNov 6, 11:52

Times in UTC, timed from the end of the recording. Medians and shares cover the latest 50 published calls. Refreshed every 15 minutes.

Parameters

Path parameters

idstringrequired

The transcript id from the event listing, beginning with tredit_ for the edited edition. An id of the raw edition returns 400.

Example: tredit_hbBlbCUawzMoz0

Response

role and company are null for the operator, and for a transcript where speakers are known only by the names on their turns.

Response fields

idstring

Unique identifier for this transcript edition, beginning with trraw_ for the raw edition.

eventstring

Identifier of the parent event, beginning with evt_. Use it to find the audio, the slides and the filings of the same call in the event listing.

symbolstring

Qualified symbol combining the exchange code and ticker separated by a colon, e.g. NASDAQ:AAPL.

fiscal_yearnumber

Fiscal year the call reports on, e.g. 2026. The fiscal year is the calendar year in which it ends. null when the period is not known.

fiscal_quarternumber

Fiscal quarter the call reports on, from 1 to 4. null for an annual period and when the quarter is not known. If the company reports semiannually, the first half is 2 and the second half is 4.

period_end_datestring

Last day of the reporting period, in YYYY-MM-DD format.

languagestring

Two-letter language code of the transcript, e.g. en. null when it is not known. Both editions of one event carry the same value.

created_atstring

ISO 8601 UTC timestamp of when this transcript was first stored.

updated_atstring

ISO 8601 UTC timestamp of when this transcript last changed.

editionstring

Always edited on this route.

segmentsarray of objects

Array of speaker turns in call order. The example call has 64 of them; the sample below is cut short.

+ Show child attributes
speaker_idstring

Key of the speaker of this turn in the speakers map, e.g. speaker_1.

textstring

Verbatim text of this turn.

speakersobject

Map from speaker id to the speaker it names. Every speaker_id in segments is a key of this map. The example call has 12 speakers.

+ Show child attributes
speaker_Nobject

One speaker. The key is the speaker_id that the segments use, where N counts up from 0: speaker_0, speaker_1 and so on.

+ Show child attributes
namestring

Name of the speaker, e.g. Tim Cook. null when it is not known.

rolestring

Role of the speaker at the time of the call, e.g. CEO. null when it is not known, which is the case for the operator and for a transcript that names its speakers only by turn.

companystring

Company the speaker belongs to, e.g. Apple. null when it is not known, which is the case for the operator and for a transcript that names its speakers only by turn.

Errors

StatuscodeWhen it happens
400invalid_parameterA malformed id, or a trraw_ id on this route.
402edited_transcript_restrictedThe key is below the Professional plan.
404resource_missingNo transcript with that id.