---
title: "List Earnings Calls"
method: GET
path: "/api/v1/earnings/"
tags: ["Earnings"]
---

# List Earnings Calls

`GET /api/v1/earnings/`

## Request

- Base URL: `https://earningscalls.dev`
- URL: `https://earningscalls.dev/api/v1/earnings/`
- Auth: API key in header `X-API-Key`

List earnings calls with filtering, sorting, and pagination. Supports filtering by sector, industry, company, ticker, exchange, country, and date range. Symbol queries always include ambiguity metadata (`ambiguous`, `issuer_count`) because one bare symbol can belong to multiple unrelated companies (e.g. SAP = SAP SE, Saputo, Sappi).

## Query parameters

- `page` integer
- `limit` integer
- `sector` string
- `industry` string
- `company` string
- `ticker` string
- `exchange` string
- `mic` string
- `country` string
- `event_type` 'earnings' | 'conference_presentation' | 'shareholder_meeting' | 'special' | 'investor_day' | 'trading_statement' | 'm_and_a' | 'guidance_update' | 'operating_results' | 'fixed_income' | 'interim_update'
- `date_from` string, date
- `date_to` string, date
- `sort` 'date_asc' | 'date_desc' | 'company_asc' | 'company_desc'
- `issuer_id` string
- `issuer_ref` string
- `strict` 0 | 1
- `group_by` 'issuer'
- `ambiguous` 1

## Response `200`

Default Response

- object
  - `data` object[]
    - `id` integer
    - `company_name` string
    - `transcript_title` string
    - `event_type` string
    - `event_date_time` string
    - `sector` string
    - `industry` string
    - `market_cap` number, nullable
    - `stock_symbol` string
    - `company_ticker` string: The STORED ticker of the row (may carry a venue suffix, e.g. 2330:TW). Never rewritten to the queried form — compare your query against `matched_alias` instead.
    - `exchange` string
    - `mic` string, nullable: ISO 10383 MIC derived from exchange (blank values are filled from the issuer's listing where known; null when unresolvable)
    - `country` string
    - `currency` string
    - `fiscal_year` integer, nullable: Fiscal year parsed from the call title (null when not present, e.g. non-earnings events)
    - `fiscal_quarter` integer, nullable: Fiscal quarter 1-4 parsed from the call title (null when not present)
    - `issuer_id` string, nullable: Stable issuer id (32-char hex, same value as `issuer_ref`) — one value per real company, identical on every listing/ticker format of that company. Null for a small share of legacy rows that cannot be resolved to an issuer.
    - `issuer_ref` string, nullable: Synonym of `issuer_id` (kept for compatibility). Null for unresolved legacy rows.
    - `isin` string, nullable: ISIN of the row's listing (falls back to the issuer's primary listing; null where unknown)
    - `timezone` string, nullable: IANA timezone of the issuer (null where unknown)
    - `matched_alias` string, nullable: Echo of the queried symbol (or the alias that resolved) — compare against your query for validation. Null on non-symbol queries.
  - `pagination` object
    - `page` integer
    - `limit` integer
    - `total` integer
    - `total_pages` integer
  - `ambiguous` boolean: True when the result set mixes two or more distinct companies (issuer_refs). Present on symbol and issuer queries.
  - `issuer_count` integer: Number of distinct resolved companies (issuer_refs) in the full result set. Present on symbol and issuer queries.
  - `issuers` object[]: Only with group_by=issuer: the distinct companies in the FULL filtered result set. Rows without a resolvable issuer are not listed as entries — they remain in `data` and the `pagination` total.
    - `issuer_ref` string, nullable
    - `issuer_id` string, nullable: Same 32-char hex id as `issuer_ref` (kept for envelope compatibility)
    - `name` string, nullable
    - `primary_symbol` string, nullable
    - `exchange` string, nullable: Display name of the issuer's primary listing venue
    - `country` string, nullable
    - `count` integer

---

[API](https://skmtc.dev/earningscalls/apis/earnings-call-transcripts-api.md) · [All operations](https://skmtc.dev/earningscalls/apis/earnings-call-transcripts-api/llms.txt) · [OpenAPI document](https://skmtc.dev/earningscalls/apis/earnings-call-transcripts-api/revisions/00131591f434?raw)