---
title: "Earnings-call digests"
method: GET
path: "/v1/stocks/{symbol}/earnings-calls/digests"
tags: ["filings"]
---

# Earnings-call digests

`GET /v1/stocks/{symbol}/earnings-calls/digests`

## Request

- Base URL: `https://api.tapetide.com`
- URL: `https://api.tapetide.com/v1/stocks/{symbol}/earnings-calls/digests`
- Auth: HTTP bearer

Digests of one company's earnings-call transcripts, newest first: a Markdown summary, highlights, risks, guidance and the headline metrics quoted, generated from the transcript the company filed with the exchange. `document_id` links to the full transcript via the documents endpoints. Pass `summary=false` for the structured fields only.

## Path parameters

- `symbol` string, required: Stock symbol, e.g. "RELIANCE". Percent-encode "&" (M%26M).

## Query parameters

- `summary` boolean
- `from` string
- `to` string
- `limit` integer
- `cursor` string

## Response `200`

OK. Costs one request unit.

- object
  - `data` StockEarningsCallDigestsItem[], required
    - `symbol` string, required: Stock symbol.
    - `document_id` integer, required: Identifier usable with `/v1/stocks/{symbol}/documents/summary` and `/documents/read` for the full transcript.
    - `call_date` string, nullable, required: Date the transcript was filed (YYYY-MM-DD).
    - `period` string, nullable, required: Month of the call, e.g. "Jul 2026".
    - `pages` integer, nullable, required: Transcript page count.
    - `summary` string, nullable, required: Investor digest of the call in Markdown; `summary_truncated` is true when cut to length.
    - `summary_truncated` boolean, required
    - `highlights` string[], required: Key points management made.
    - `risks` string[], required: Risks and headwinds discussed.
    - `guidance` string[], required: Forward-looking statements and guidance.
    - `key_metrics` object[], required: Headline numbers quoted on the call.
      - `metric` string, required: Metric name as stated on the call, e.g. "Revenue".
      - `value` string, required: Value as stated, with its unit, e.g. "₹72,275 crore" or "24%".
      - `period` string, nullable, required: Period the value refers to, e.g. "Q1 FY2027".
    - `transcript_url` string, nullable, required: Public URL of the filed transcript PDF.
  - `meta` ListMeta, required
    - `as_of` string, date-time, required: When this response was assembled (UTC).
    - `route` string, required: operationId that served the request.
    - `count` integer, required: Items in this page.
    - `limit` integer, required: Page size applied.
    - `has_more` boolean, required: Whether another page exists.
    - `next_cursor` string, nullable, required: Pass as `cursor` to fetch the next page; null on the last page.
  - `links` Links, required
    - `next` string, nullable: Relative URL of the next page, or null.

## Other responses

- `400`: Malformed or out-of-range parameter. Not charged.
- `401`: Missing or invalid bearer token.
- `404`: The requested resource does not exist. Not charged.
- `429`: Per-minute burst cap (`rate_limited`) or plan quota (`quota_exhausted`) reached.
- `500`: Unexpected server error. Not charged.
- `502`: A data dependency was unavailable. Not charged.
- `503`: Authentication or quota service temporarily unavailable (`service_unavailable`). Not charged; retry after `Retry-After` seconds.

---

[API](https://skmtc.dev/tapetide/apis/tapetide-api.md) · [All operations](https://skmtc.dev/tapetide/apis/tapetide-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tapetide/apis/tapetide-api/revisions/261ec086bde5?raw)