List earnings calls

Return one row per earnings call, newest period first, with the ids of everything attached to it: the transcript in a raw and an edited edition, the audio recording, the slide deck of the earnings presentation and the filings. By default the collection spans every company; pass identifier to restrict it to one. Calls with no content are never listed, so every row has at least one id to follow.

Pass the ids to the content routes. A free or Individual key sees the latest 2 calls per company, and a Professional key the whole history. The listing never shows a call that retrieval would refuse.

GET/v3.0.0/company-events

Plan Access

Free

(Your plan)

Individual

$29/mo

Professional

$89/mo

Plan History

Free

(Your plan)

2 quarters

Individual

$29/mo

2 quarters

Professional

$89/mo

All available quarters

Request
curl "https://api.roic.ai/v3.0.0/company-events?apikey=YOUR_API_KEY&identifier=NASDAQ:AAPL&limit=2"
Response
200 OK
{
  "data": [
    {
      "id": "evt_hbBlbCUawzMoz0",
      "symbol": "NASDAQ:AAPL",
      "fiscal_year": 2026,
      "fiscal_quarter": 3,
      "period_end_date": "2026-06-30",
      "release_date": "2026-07-30",
      "created_at": "2026-07-30T21:10:12.004Z",
      "updated_at": "2026-08-04T09:03:55.085Z",
      "transcripts": [
        {
          "id": "trraw_hbBlbCUawzMoz0",
          "type": "raw",
          "language": "en",
          "created_at": "2026-07-31T01:58:44.231Z",
          "updated_at": "2026-08-02T11:22:39.085Z"
        },
        {
          "id": "tredit_hbBlbCUawzMoz0",
          "type": "edited",
          "language": "en",
          "created_at": "2026-08-03T03:41:12.085Z",
          "updated_at": "2026-08-04T09:03:55.085Z"
        }
      ],
      "audio": [
        {
          "id": "audio_7Ft0XPWQVpVeJ1",
          "filename": "NASDAQ-AAPL_earnings-call_2026-06-30_FY2026-Q3_audio_7Ft0XPWQVpVeJ1.mp3",
          "document_group": "audio",
          "document_kind": "earnings_call",
          "language": "en"
        }
      ],
      "slides": [],
      "filings": [
        {
          "id": "doc_4JlukNobJIA1qj",
          "filename": "NASDAQ-AAPL_earnings-release-8-K_2026-06-30_FY2026-Q3_doc_4JlukNobJIA1qj.pdf",
          "form": "8-K",
          "document_group": "earnings",
          "document_kind": "earnings_release",
          "language": "en"
        },
        {
          "id": "doc_ZpmmlIbhByf2jK",
          "filename": "NASDAQ-AAPL_quarterly-report-10-Q_2026-06-30_FY2026-Q3_doc_ZpmmlIbhByf2jK.pdf",
          "form": "10-Q",
          "document_group": "financial_report",
          "document_kind": "quarterly_report",
          "language": "en"
        }
      ]
    }
  ],
  "next_page_url": "/v3.0.0/company-events?identifier=NASDAQ%3AAAPL&limit=2&page=page_v1_k1_AFFDSlfWadJ...",
  "previous_page_url": null
}

Availability

How soon after an earnings call each kind of content is attached to it.

35
calls in the last 7 days
17 min
audio, median after the call
2%
calls with a slide deck
8%
calls with filings
CompanyCall, UTCAudioSlidesFilings
STO:ATRLJ_BAtrium Ljungberg AB Class BOct 9, 08:1529 min+14 minNoneNone
NYSE:PKEPark Aerospace Corp.Oct 8, 21:0059 min+15 minNoneNone
TSX:ATZAritzia, Inc.Oct 8, 20:3049 min+15 minNoneNone
AMEX:NGNovagold Resources Inc.Oct 8, 15:0039 min+22 minNoneNone
NASDAQ:RELLRichardson Electronics, Ltd.Oct 8, 14:0045 min+19 minNoneNone
TSX:RCHRichelieu Hardware LtdOct 8, 14:0025 min+23 minNoneNone
NSE:TCSTata Consultancy Services LimitedOct 8, 13:301h 08m+4 minNoneNone
NASDAQ:BYRNByrna Technologies, Inc.Oct 8, 13:0049 min+18 minNoneNone
NASDAQ:HELEHelen of Troy LimitedOct 8, 13:0046 min+6 minNoneNone
NASDAQ:LFSLEIFRAS Co., Ltd.Oct 8, 12:3041 min+6h 10mNoneNone
NASDAQ:TLRYTilray Brands, Inc.Oct 8, 12:301h 02m+14 minNoneNone
TSX:FTGFiran Technology Group CorporationOct 8, 12:3050 min+17 minNoneNone

Times in UTC. Audio is timed from the end of the recording; slides and filings from the start of the call, so a minus sign means published ahead of it. Medians and shares cover the latest 50 published calls. Refreshed every 15 minutes.

Parameters

Query parameters

identifierstringoptional

Restrict results to a single company. Accepts an exchange and symbol separated by a colon (e.g. NASDAQ:AAPL), a ticker ID, or a FIGI; the response symbol echoes the listing you requested. Omit to list events across all companies.

Example: NASDAQ:AAPL
contentstringoptional

Keep only the events that carry this kind of content. Omit to list every event that carries at least one kind.

Values: transcriptaudioslidesfilings
orderstringoptional

Sort by period end date (period_end_date).

Default: descValues: ascdesc
limitintegeroptional

Maximum number of resources to return.

Default: 50Min: 1Max: 100
pagestringoptional

Token to request the next page of data. Each response returns ready-made next_page_url and previous_page_url (null on the last and first page, respectively) that repeat your filters with this token. They are relative and carry no credentials: prefix the API host and pass apikey separately, or keep sending your Authorization header.

Response

Each item is one earnings call. Its transcripts array holds the raw entry first and the edited entry second; audio, slides and filings are empty when the call carries nothing of that kind. Follow next_page_url unchanged to page through results.

Response fields

dataarray of objects

Array of event resources for the current page, newest period first unless you pass order=asc. An event that carries no content at all is never listed.

+ Show child attributes
idstring

Unique identifier for the event, beginning with evt_. Inside transcripts, audio, slides and filings it is the id of that item instead: trraw_ and tredit_ for the two transcript editions, audio_ for a recording, doc_ for a slide deck or a filing. Pass it to the route that serves its prefix.

symbolstring

Qualified symbol combining the exchange code and ticker separated by a colon, e.g. NASDAQ:AAPL. It echoes the listing you asked for, even when the company reports under another listing.

fiscal_yearnumber

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

fiscal_quarternumber

Fiscal quarter the event 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.

release_datestring

UTC calendar date the results were released, in YYYY-MM-DD format. null when the release date is not known.

created_atstring

ISO 8601 UTC timestamp of when the resource was first stored. On the event it is the earliest created_at of everything attached to it.

updated_atstring

ISO 8601 UTC timestamp of when the resource last changed. On the event it is the latest updated_at of everything attached to it.

transcriptsarray of objects

Array of transcript editions of this event, the raw entry first and the edited entry second. Pass the id of an entry to the raw transcript or the edited transcript route. Both entries carry the same language. Empty when the event has no transcript.

+ Show child attributes
idstring

Unique identifier for the event, beginning with evt_. Inside transcripts, audio, slides and filings it is the id of that item instead: trraw_ and tredit_ for the two transcript editions, audio_ for a recording, doc_ for a slide deck or a filing. Pass it to the route that serves its prefix.

typestring

Edition of the transcript entry: raw for plain text without speakers, edited for speaker-labeled segments. Each edition has its own route.

languagestring

Two-letter language code of the content, e.g. en. null when it is not known.

created_atstring

ISO 8601 UTC timestamp of when the resource was first stored. On the event it is the earliest created_at of everything attached to it.

updated_atstring

ISO 8601 UTC timestamp of when the resource last changed. On the event it is the latest updated_at of everything attached to it.

audioarray of objects

Array of call recordings attached to this event. Pass an id from it to the call audio route for a download link. Empty when no recording is available.

+ Show child attributes
idstring

Unique identifier for the event, beginning with evt_. Inside transcripts, audio, slides and filings it is the id of that item instead: trraw_ and tredit_ for the two transcript editions, audio_ for a recording, doc_ for a slide deck or a filing. Pass it to the route that serves its prefix.

filenamestring

Download name of the file, built from the event and the document, e.g. NASDAQ-AAPL_earnings-release-8-K_2026-06-30_FY2026-Q3_doc_4JlukNobJIA1qj.pdf. The fiscal label appears only when the period is certain, and the language code only when the file is not in English.

document_groupstring

Bucket the document falls in, for filtering: earnings, financial_report, presentation, regulatory, sustainability or other. A recording always uses audio, because the call itself is not one of the document groups.

document_kindstring

The document named the way the industry does, e.g. earnings_release, quarterly_report, annual_report or presentation. A recording always uses earnings_call. A document we cannot type lands on other.

languagestring

Two-letter language code of the content, e.g. en. null when it is not known.

slidesarray

Array of slide decks attached to this event. Pass an id from it to the slide decks route for a download link. Empty when no deck is available.

filingsarray of objects

Array of filings attached to this event, such as the earnings release and the quarterly report. Pass an id from it to the filings route for a download link. Empty when no filing is available.

+ Show child attributes
idstring

Unique identifier for the event, beginning with evt_. Inside transcripts, audio, slides and filings it is the id of that item instead: trraw_ and tredit_ for the two transcript editions, audio_ for a recording, doc_ for a slide deck or a filing. Pass it to the route that serves its prefix.

filenamestring

Download name of the file, built from the event and the document, e.g. NASDAQ-AAPL_earnings-release-8-K_2026-06-30_FY2026-Q3_doc_4JlukNobJIA1qj.pdf. The fiscal label appears only when the period is certain, and the language code only when the file is not in English.

formstring

Regulatory code of the filing, e.g. 8-K, 10-Q, 10-K, 6-K or 20-F. null when the document carries no regulatory code, as a slide deck does not.

document_groupstring

Bucket the document falls in, for filtering: earnings, financial_report, presentation, regulatory, sustainability or other. A recording always uses audio, because the call itself is not one of the document groups.

document_kindstring

The document named the way the industry does, e.g. earnings_release, quarterly_report, annual_report or presentation. A recording always uses earnings_call. A document we cannot type lands on other.

languagestring

Two-letter language code of the content, e.g. en. null when it is not known.

next_page_urlstring

URL of the next page of results, or null when there are no more pages. It is relative to the API host and carries no API key, so request it with the same authentication as the first call.

previous_page_urlnullable

URL of the previous page of results, or null on the first page.

Examples

The calls of one company that have a transcript:

curl "https://api.roic.ai/v3.0.0/company-events?apikey=YOUR_API_KEY&identifier=NASDAQ:AAPL&content=transcript"

The most recent calls across the market with a slide deck:

curl "https://api.roic.ai/v3.0.0/company-events?apikey=YOUR_API_KEY&content=slides&limit=20"

Errors

StatuscodeWhen it happens
400invalid_parameterA bare symbol, or a bad content, order or limit value.
400invalid_page_tokenA page token that was built or edited by hand.
404resource_missingThe identifier matches no company.