# Earnings Calendar

Return earnings events across the whole ISO date window (up to 14 days) with ticker, company, market cap and EPS and sales values. The response reports the effective range.

- **Documentation:** [https://scrappa.co/docs/finviz-api/finviz_earnings_calendar](https://scrappa.co/docs/finviz-api/finviz_earnings_calendar)
- **API group:** Finviz API
- **Endpoint:** `GET https://scrappa.co/api/finviz/earnings-calendar`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `date_from` | string | Yes | Start date, YYYY-MM-DD. Required. |
| `date_to` | string | Yes | End date, YYYY-MM-DD. Required. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/finviz/earnings-calendar?date_from=2026-11-18&date_to=2026-11-25"
```

## Example response

```json
{
    "events": [
        {
            "date": "2026-11-19",
            "ticker": "AAPL",
            "epsEstimate": 1.85
        }
    ],
    "page": 1,
    "source": "finviz"
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
|  | No events | No events in the window. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)
