List Earnings Calls
GET
/api/v1/earnings/
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).
Parameters
| Name | In | Type | Description |
|---|---|---|---|
page optional |
query | integer | Page number |
limit optional |
query | integer | Results per page |
sector optional |
query | string | Filter by sector |
industry optional |
query | string | Filter by industry |
company optional |
query | string | Filter by company name (partial match) |
ticker optional |
query | string | Filter by company ticker (exact, case-insensitive; matches exchange-suffix variants like ALAB:US too). If no rows match, known cross-listing aliases resolve to the issuer's primary record (e.g. TSM returns the same issuer as 2330). Use strict=1 to disable both behaviors. The queried symbol is echoed on every item as `matched_alias`; `company_ticker`/`stock_symbol` always carry the stored value. |
exchange optional |
query | string | Filter by exchange name, exact (e.g. NASDAQ, NYSE, NSEI). Use `mic` for the ISO-10383 form. |
mic optional |
query | string | ISO 10383 Market Identifier Code (e.g. XNAS, XNYS, XNSE) — disambiguates symbol collisions across venues. Also matches rows whose stored exchange is blank when the issuer's primary listing carries the MIC (mirrors the served mic fill). |
country optional |
query | string | Filter by ISO-3166 alpha-2 country code (e.g. US, IN, CA) |
event_type optional |
query | string | Filter by event type (e.g. earnings, conference_presentation, shareholder_meeting, special, investor_day) |
date_from optional |
query | string | Events from this date (YYYY-MM-DD) |
date_to optional |
query | string | Events until this date (YYYY-MM-DD) |
sort optional |
query | string | Sort order |
issuer_id optional |
query | string | Filter by issuer id (the `issuer_id` field on any item — 32-char hex, identical to `issuer_ref`). Returns all events for that company across every ticker format. Unknown ids return an empty result. Mutually exclusive with `ticker` and `issuer_ref`. |
issuer_ref optional |
query | string | Synonym of `issuer_id` (the same 32-char hex id, kept for compatibility). Mutually exclusive with `ticker` and `issuer_id`. |
strict optional |
query | integer | strict=1 disables ticker-variant matching and the cross-listing alias fallback — only rows whose stored company_ticker or stock_symbol equals the query exactly are returned. |
group_by optional |
query | string | group_by=issuer appends a top-level `issuers` summary of the distinct companies, grouped by de-duplicated `issuer_ref`. With a `ticker`/`issuer_id`/`issuer_ref` filter the summary covers the FULL filtered result set; on unfiltered browse queries it covers the current page only. `data` and `pagination` are unchanged. |
ambiguous optional |
query | integer | Accepted for symmetry — the ambiguity metadata (`ambiguous`, `issuer_count`) is always included on symbol and issuer queries and cannot be disabled. |
Example request
curl "https://earningscalls.dev/api/v1/earnings/?page=value" \ -H "X-API-Key: YOUR_API_KEY"
Authenticate with your API key in the X-API-Key header (or api_key query parameter). Get a key on the pricing page. Try any endpoint interactively in the Swagger console, and see the full OpenAPI spec.