---
source_url: "https://www.roic.ai/api/docs/earnings-calls"
title: "Earnings Call Transcripts API - Discover & Retrieve Calls | Roic AI"
mirrored_at: 2026-08-14T03:34:08.821Z
host: www.roic.ai
cited_in_42a: true
mirror_canonical: "https://index.42a.ai/www.roic.ai/api/docs/earnings-calls"
---

> **Original source:** https://www.roic.ai/api/docs/earnings-calls

Discover available earnings calls without downloading transcript text, then retrieve only the calls you need. Summary resources provide company identity, fiscal period, call date, and a stable `ecall_` public ID for durable links.

## Choose an earnings-call endpoint

The route family separates discovery from content retrieval.

Goal

Endpoint

Result

Browse calls across companies

[List earnings calls](https://www.roic.ai/api/docs/earnings-calls/list)

Cursor-paginated summary resources.

Find calls for one company or date range

[List earnings calls](https://www.roic.ai/api/docs/earnings-calls/list) with filters

Summaries without transcript text.

Read one selected call

[Retrieve an earnings call](https://www.roic.ai/api/docs/earnings-calls/transcript)

A full transcript resource.

Feed plain text into a text pipeline

Retrieve with `format=text`

One raw transcript string.

## Move from discovery to retrieval

List calls first and use the summary metadata to select a fiscal period. Store the returned `id`, then pass that `ecall_` ID to the retrieve route. The list returns `v3.content.earnings_call` objects; retrieval returns a `v3.content.earnings_call_transcript` object that adds `transcript`.

The retrieve route defaults to `format=json`, where `transcript` is an array of speaker and text turns. Use `format=text` when your application needs a single string. Follow list cursor URLs unchanged and continue sending your Bearer header on every page request.

## Common use cases

Use transcript resources for workflows that depend on management commentary.

-   **Transcript archives**. Build a searchable archive of calls by company and fiscal period, using stable `ecall_` IDs for durable transcript links.
-   **Guidance extraction**. Extract revenue guidance, capital spending plans, and margin commentary for use in forecasts and research notes.
-   **Management trend analysis**. Compare management themes and language across several quarters to see how priorities, risks, and explanations change.
-   **NLP pipelines**. Run sentiment, topic, or speaker-level analysis on structured transcript turns without first parsing one large text block.
-   **Competitive intelligence**. Review how competitors discuss pricing, demand, and market conditions across calls from the same reporting period.
-   **Event-linked research**. Link earnings-calendar events to the corresponding reported call so users can move from results to management commentary.

## History access

Your plan controls how much transcript history is available. v2 and v3 use the same plan and request-limit bucket.

## Next steps

Implement discovery first, then add transcript retrieval.