# Earnings calendar: `POST /v1/markets/earnings_calendar`

Cost: 2 credits (2 per day (a day with no reports and failed requests are free)). Docs: https://scrapercompany.com/docs/reference/earnings-calendar

Every US-listed company due to report earnings on one day, largest
market cap first: symbol, name, before the open or after the close,
market cap, fiscal quarter, consensus EPS forecast and the number of
estimates, and last year's report date and EPS. A day with no reports
(weekends) is an empty list and is not charged.

Request body (JSON):

- `day` (string (date); required): The report day.
- `limit` (integer; optional; default 500; min 1, max 1000): Most companies returned, largest market cap first.

Base URL: `https://api.scrapercompany.com`. Auth: send your key in the `x-api-key` header. A failed request (4xx or 5xx) or an empty result costs 0 credits.

- [Full API reference as one Markdown file](https://scrapercompany.com/llms-full.txt)
- [OpenAPI spec](https://scrapercompany.com/openapi.json)