Get Upcoming Earnings Calls
GET
/api/v1/earnings/upcoming
Get scheduled earnings calls that have not yet occurred. Combines data from earnings_calendar (upcoming) and earnings_calls (if any future entries exist). Upcoming rows carry no venue identity, so `mic` is rejected with 400 rather than silently ignored. Calendar rows resolve to an issuer by symbol where that mapping is unambiguous.
Parameters
| Name | In | Type | Description |
|---|---|---|---|
limit optional |
query | integer | Number of results (max 100) |
days optional |
query | integer | Days ahead to look (max 30) |
symbol optional |
query | string | Filter by ticker symbol |
issuer_id optional |
query | string | Filter by issuer id (32-char hex, identical to `issuer_ref`) — resolved to the issuer's known listing and alias symbols. Mutually exclusive with `symbol` and `issuer_ref`. |
issuer_ref optional |
query | string | Synonym of `issuer_id`. Mutually exclusive with `symbol` and `issuer_id`. |
group_by optional |
query | string | group_by=issuer appends a top-level `issuers` summary of the distinct companies among the returned rows. |
mic optional |
query | string | NOT SUPPORTED on this endpoint — always rejected with 400 (upcoming rows carry no venue identity to filter on). |
Example request
curl "https://earningscalls.dev/api/v1/earnings/upcoming?limit=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.