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.
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) |
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. |
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 |
Example request
curl "https://earningsapi.io/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.