Earnings

List Earnings Calls

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).

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

Query parameters

pageinteger

Page number

limitinteger

Results per page

sectorstring

Filter by sector

industrystring

Filter by industry

companystring

Filter by company name (partial match)

tickerstring

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.

exchangestring

Filter by exchange name, exact (e.g. NASDAQ, NYSE, NSEI). Use mic for the ISO-10383 form.

micstring

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).

countrystring

Filter by ISO-3166 alpha-2 country code (e.g. US, IN, CA)

event_type'earnings' | 'conference_presentation' | 'shareholder_meeting' | 'special' | 'investor_day' | 'trading_statement' | 'm_and_a' | 'guidance_update' | 'operating_results' | 'fixed_income' | 'interim_update'

Filter by event type (e.g. earnings, conference_presentation, shareholder_meeting, special, investor_day)

date_fromstring date

Events from this date (YYYY-MM-DD)

date_tostring date

Events until this date (YYYY-MM-DD)

sort'date_asc' | 'date_desc' | 'company_asc' | 'company_desc'

Sort order

issuer_idstring

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_refstring

Synonym of issuer_id (the same 32-char hex id, kept for compatibility). Mutually exclusive with ticker and issuer_id.

strict0 | 1

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'issuer'

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.

ambiguous1

Accepted for symmetry — the ambiguity metadata (ambiguous, issuer_count) is always included on symbol and issuer queries and cannot be disabled.

Response

Default Response

ambiguousboolean

True when the result set mixes two or more distinct companies (issuer_refs). Present on symbol and issuer queries.

issuer_countinteger

Number of distinct resolved companies (issuer_refs) in the full result set. Present on symbol and issuer queries.

Changes

No recorded changes to this operation across all 1 revision of this API.