List Earnings Calls

Get a complete list of all available earnings call transcripts for a company. This endpoint returns metadata for each transcript including the fiscal year, quarter number, and call date. without the full transcript text.

Use this endpoint to discover which earnings calls are available before fetching individual transcripts. This is useful for building UI selectors, populating earnings call timelines, or determining the date range of available data for a given company.

GEThttps://api.roic.ai/v2/company/earnings-calls/list/{identifier}
Request
curl "https://api.roic.ai/v2/company/earnings-calls/list/AAPL?apikey=YOUR_API_KEY"
Response
200 OK
[
  {
    "symbol": "AAPL",
    "year": 2024,
    "quarter": 4,
    "date": "2024-10-31"
  },
  {
    "symbol": "AAPL",
    "year": 2024,
    "quarter": 3,
    "date": "2024-08-01"
  }
]

Parameters

Path parameters

identifierstringrequired

Company identifier — supports ticker symbol (e.g., AAPL), CIK, CUSIP, or ISIN.

Example: AAPL

Query parameters

limitnumber

Maximum number of earnings calls to return.

Default: 100
formatstring

Response format. Use json for JSON (default) or excel for tab-separated values compatible with Google Sheets and Excel.

Default: jsonValues: jsonexcel

Response

Response fields

symbolstring

The ticker symbol of the company that held the call, e.g. AAPL.

yearnumber

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

quarternumber

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

datestring

Calendar date the call took place, in YYYY-MM-DD format.

Use Cases

  • Earnings call navigation. Build dropdown selectors or timelines that let users browse available transcripts by quarter
  • Data coverage checks. Determine which quarters have transcript data before running batch analysis jobs
  • Historical analysis setup. Identify the full date range of available calls before fetching transcripts for multi-year research
  • Transcript archive tools. Display a company's earnings reporting history with exact call dates
  • Batch processing pipelines. List all available calls, then fetch each transcript in parallel for NLP or data extraction workflows

Related Endpoints