# Earnings History

`GET` `https://api.unusualwhales.com/api/stock/{ticker}/earnings`

Returns earnings data including reported EPS, estimated EPS, surprise amount,
surprise percentage, and report timing (pre/post market).


## Authentication

```
Authorization: Bearer YOUR_API_KEY
```

## Path Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `ticker` | SingleTicker | Yes | A single ticker |


## Response (200)

| Field | Type | Description |
|-------|------|-------------|
| `estimated_eps` | string |  |
| `fiscal_date_ending` | string |  |
| `inserted_at` | string |  |
| `report_date` | string |  |
| `report_time` | string | Normalized to "premarket" / "postmarket"; earnings-calendar rows may pass through "bmo" / "amc". |
| `report_type` | string |  |
| `reported_eps` | string |  |
| `surprise` | string |  |
| `surprise_percentage` | string |  |
| `ticker` | string |  |
| `updated_at` | string |  |


## Example

### curl

```bash
curl -X GET "https://api.unusualwhales.com/api/stock/{ticker}/earnings" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"
```

### Python

```python
import http.client

conn = http.client.HTTPSConnection("api.unusualwhales.com")
headers = {"Authorization": "Bearer YOUR_API_KEY", "Accept": "application/json"}
conn.request("GET", "/api/stock/{ticker}/earnings", headers=headers)
response = conn.getresponse()
print(response.read().decode("utf-8"))
```

## Response Example

```json
{
  "data": [
    {
      "estimated_eps": "1.60",
      "fiscal_date_ending": "2024-09-30",
      "inserted_at": "2026-07-29T12:34:56Z",
      "report_date": "2024-10-31",
      "report_time": "postmarket"
    }
  ]
}
```