Earnings

Get Upcoming Earnings Calls

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.

get/api/v1/earnings/upcoming

Request

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

Query parameters

limitinteger

Number of results (max 100)

daysinteger

Days ahead to look (max 30)

symbolstring

Filter by ticker symbol

symbolsstring

Comma-separated ticker symbols (max 100), exact case-insensitive match. Mutually exclusive with symbol and issuer_id/issuer_ref.

issuer_idstring

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_refstring

Synonym of issuer_id. Mutually exclusive with symbol and issuer_id.

group_by'issuer'

group_by=issuer appends a top-level issuers summary of the distinct companies among the returned rows.

micstring

NOT SUPPORTED on this endpoint — always rejected with 400 (upcoming rows carry no venue identity to filter on).

Response

Default Response

Changes

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