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).
Parameters
| Name | In | Type | Description |
|---|---|---|---|
date_from required |
query | string | Start of the range (YYYY-MM-DD), inclusive. |
date_to required |
query | string | End of the range (YYYY-MM-DD), inclusive. Max 92 days after date_from. |
page optional |
query | integer | Page number |
limit optional |
query | integer | Rows per page (max 500) |
symbols optional |
query | string | Comma-separated ticker symbols (max 200), exact case-insensitive match. Mutually exclusive with issuer_ids. |
issuer_ids optional |
query | string | 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_since optional |
query | string | ISO 8601 timestamp — only rows added or changed since then. Combine with your last pull time for delta syncs. |
Example request
curl "https://earningsapi.io/api/v1/earnings/calendar?date_from=value&date_to=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.