Earnings

Earnings Calendar (Date Range)

Bulk earnings calendar over an arbitrary date range (max 92 days per request), paginated up to 500 rows per page. Supports multi-symbol and multi-issuer filters and updated_since for cheap delta syncs. Placeholder clock times are served as event_time: null plus a session hint (before_open / after_close / unknown) — never as a fake timestamp. Rows resolve to an issuer by symbol only when that mapping is unambiguous, and carry call_id once a matching earnings call exists in the archive. Calendar rows carry no venue identity (mic/exchange/country are not available on this endpoint).

get/api/v1/earnings/calendar

Request

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

Query parameters

date_fromstring date required

Start of the range (YYYY-MM-DD), inclusive.

date_tostring date required

End of the range (YYYY-MM-DD), inclusive. Max 92 days after date_from.

pageinteger

Page number

limitinteger

Rows per page (max 500)

symbolsstring

Comma-separated ticker symbols (max 200), exact case-insensitive match. Mutually exclusive with issuer_ids.

issuer_idsstring

Comma-separated issuer ids (32-char hex, the same values as issuer_ref; max 100). Each id resolves to the issuer's known listing and alias symbols. Unknown ids match nothing. Mutually exclusive with symbols.

updated_sincestring

ISO 8601 timestamp — only rows added or changed since then. Combine with your last pull time for delta syncs.

Response

Default Response

Changes

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