# Earnings releases

> The press-release exhibit furnished with each 8-K that reports results, with its title and plain text.

```text
GET /v1/companies/{id}/earnings-releases
GET /v1/companies/{id}/earnings-releases/{accession}
```

The press-release exhibit furnished with each 8-K that includes Item 2.02 (Results of Operations and Financial Condition). The list is sorted newest filed first and has no text. The detail route returns one release with its plain text. We don't extract figures from the text.

```bash
curl -H "X-API-Key: $BELFORT_API_KEY" \
  "https://belfort-data-api.vercel.app/v1/companies/AAPL/earnings-releases?limit=20"
```

```bash
curl -H "X-API-Key: $BELFORT_API_KEY" \
  "https://belfort-data-api.vercel.app/v1/companies/AAPL/earnings-releases/0000320193-25-000001"
```

## Parameters

| Parameter | Values | Default |
|---|---|---|
| `limit` | 1–100 releases per page. | 20 |
| `cursor` | The previous page's `meta.next_cursor`. | |
| `from` | Earliest filed date to include, `YYYY-MM-DD`. | |
| `to` | Latest filed date to include, `YYYY-MM-DD`. | |

The detail route takes the `accession` in the path, in the form `##########-##-######`.

## One release

| Field | Meaning |
|---|---|
| `accession` | The 8-K filing the exhibit came from. |
| `filed` | The day the filing was made. |
| `period` | The period the release reports on. |
| `title` | The release's title, or `null`. See below. |
| `title_source` | How the title was produced, such as `llm_verified`. |
| `exhibit_type`, `exhibit_description` | The exhibit's type and description as filed, such as `EX-99.1`. |
| `items` | The 8-K item numbers the filing reports, such as `2.02` and `9.01`. |
| `exhibit_url` | The exhibit on EDGAR. |
| `filing_url` | The filing's index page on EDGAR. |
| `text` | The exhibit as plain text. Only on the detail route. |

## What to expect

- **Coverage starts on 2024-01-01.**
- **No figures are extracted.** You get the release as the company wrote it.
- **Not every Item 2.02 exhibit is an earnings release.** Some are slide decks, call transcripts or other announcements. Use `exhibit_description`, `exhibit_type` and `items` to tell them apart.
- **Titles are proposed by an AI model** and verified word for word against the exhibit text. A title can be `null`. The measured check is on [Quality](/quality/#earnings-releases).
- **The list has no `text`.** Call the detail route for the text of one release.

---
Source: https://docs.belfortagent.xyz/datasets/earnings-releases/