Financial Data API

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}

Parameters

Path Parameters

identifierstringrequired

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

Example: AAPL

Query Parameters

apikeystringrequired

Your API key for authentication.

limitnumberoptional

Maximum number of earnings calls to return.

Default: 100
formatstringoptional

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

Default: jsonValues: json, excel

Code Examples

curl "https://api.roic.ai/v2/company/earnings-calls/list/AAPL?apikey=YOUR_API_KEY"

Response

Response200 OK
[
  {
    "symbol": "AAPL",
    "year": 2024,
    "quarter": 4,
    "date": "2024-10-31"
  },
  {
    "symbol": "AAPL",
    "year": 2024,
    "quarter": 3,
    "date": "2024-08-01"
  }
]

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
  • Earnings calendar 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