# Filings

> Every filing a company made with the SEC, newest first, with links to EDGAR.

```text
GET /v1/companies/{id}/filings
```

A company's filings list from the SEC's submissions data, newest first: every form, not only financial reports.

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

## Parameters

| Parameter | Values | Default |
|---|---|---|
| `limit` | 1–50 rows per page. | 20 |
| `cursor` | The previous page's `meta.next_cursor`. | |

## One filing

| Field | Meaning |
|---|---|
| `cik`, `name` | The company. |
| `accession` | The filing's SEC accession number. |
| `form` | The form, such as `10-K`, `8-K` or `4`. |
| `filed` | The day it was filed. |
| `report_date` | The period the filing reports on, when it has one. |
| `primary_document` | The filing's main document. |
| `filing_url` | The filing's index page on EDGAR. |

Use this list to find a filing, then the dataset routes to read its figures. Every figure elsewhere in the API carries an accession you can look up here.

---
Source: https://docs.belfortagent.xyz/datasets/filings/