List earnings calls

Return a filterable, market-wide page of earnings-call summaries. By default the collection spans every company; pass identifier to restrict it to one. Summaries omit transcript text and carry the fiscal period you need to retrieve a full transcript.

GET/v3.0.0/earnings-calls

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?apikey=YOUR_API_KEY&identifier=NASDAQ:AAPL&order=desc"
Response
200 OK
{
  "data": [
    {
      "id": "ecall_Jk8mN2pQ4rS6tV",
      "object": "v3.content.earnings_call",
      "symbol": "NASDAQ:AAPL",
      "fiscal_year": 2026,
      "fiscal_quarter": 2,
      "date": "2026-05-01"
    }
  ],
  "next_page_url": null,
  "previous_page_url": null
}

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 earnings calls across all companies.

Example: NASDAQ:AAPL
fiscal_yearintegeroptional

Return only calls that report on this fiscal year.

Example: 2026
fiscal_quarterintegeroptional

Return only calls that report on this fiscal quarter, from 1 to 4.

Example: 2Min: 1Max: 4
datestringoptional

Pass a YYYY-MM-DD UTC calendar date directly for an exact call-date match. For a range, combine the modifiers below, for example, date.gte=2026-01-01&date.lt=2026-04-01.

+ Show filter modifiers
date.gtestring

Return calls whose UTC calendar date is greater than or equal to the given date.

date.gtstring

Return calls whose UTC calendar date is strictly greater than the given date.

date.ltestring

Return calls whose UTC calendar date is less than or equal to the given date.

date.ltstring

Return calls whose UTC calendar date is strictly less than the given date.

orderstringoptional

Sort by reporting-period date (fiscal_year, then fiscal_quarter).

Default: descValues: ascdesc
limitintegeroptional

Maximum number of resources to return.

Default: 50Min: 1Max: 100
pagestringoptional

Opaque page token from a previous response. Follow the returned page URL when possible.

Pagination URLs

next_page_urlstring | null

Ready-made URL of the next page, returned in the response. Request it unchanged to continue paging; null on the last page. It carries no credentials, so pass apikey separately or use the Authorization header.

previous_page_urlstring | null

Ready-made URL of the previous page, returned in the response. Request it unchanged to page back; null on the first page. It carries no credentials, so pass apikey separately or use the Authorization header.

Response

Each item is a v3.content.earnings_call. To read the transcript, take the id from a list item and call the retrieve route, which returns a v3.content.earnings_call_transcript resource with the full transcript.

Response fields

dataarray of objects

Array of earnings-call summary resources for the current page.

+ Show child attributes
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.

next_page_urlnullable

URL of the next page of results, or null when there are no more pages. Request it unchanged to continue paging.

previous_page_urlnullable

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

Examples

Combine the filters below to answer common questions. Each request is runnable.

The most recent earnings calls across all companies:

curl "https://api.roic.ai/v3.0.0/earnings-calls?apikey=YOUR_API_KEY&order=desc&limit=10"

The four most recent calls for one company:

curl "https://api.roic.ai/v3.0.0/earnings-calls?apikey=YOUR_API_KEY&identifier=NASDAQ:AAPL&limit=4"

Calls held on one exact UTC calendar date:

curl "https://api.roic.ai/v3.0.0/earnings-calls?apikey=YOUR_API_KEY&identifier=NASDAQ:AAPL&date=2025-01-30"

One company's calls over the last year, using a date.gte=2025-01-01 lower bound:

curl "https://api.roic.ai/v3.0.0/earnings-calls?apikey=YOUR_API_KEY&identifier=NASDAQ:AAPL&date.gte=2025-01-01"

Related endpoints

Retrieve transcript content after you select a summary.