# GET /v3/reports

Reports of one entity: one row per version chain (an original plus its amendments), ordered by the original filing's date, newest first (a chain whose original is not ingested is dated by its first ingested amendment). form and period filter on that first filing (period on its stored period_of_report: SEC's reportDate when it gives one). A filing that is not an amendment is listed as soon as it is ingested, as a chain of one; an amendment joins its chain (or is listed as its own, when it cannot be linked) once the linker has processed it, and is absent until then. period_of_report and latest.accepted_at are the stored values (snapshot block: the snapshot they come from).

**API key:** required. See [Authentication](https://www.secblast.com/docs/authentication).

**Group:** [Filings](https://www.secblast.com/docs/reference#filings)

## Parameters

| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
| `cik` | query | string | yes |   | Primary CIK of the report, padded or unpadded. Required. |
| `form` | query | comma-separated list of string | no |   | Base form(s) of the chain's first filing, exact, e.g. 10-K or 10-K,10-Q. |
| `period` | query | date (YYYY-MM-DD) | no |   | Only chains whose first filing has this period_of_report. |
| `limit` | query | integer | no | `50` | Page size, 1..200. |
| `cursor` | query | string | no |   | Opaque cursor from a previous page's next_cursor. Must be used with the same filters. |

## Responses

| Status | Body | Description |
|---|---|---|
| `200` | [ReportList](https://www.secblast.com/docs/reference/schemas#schema-reportlist) (`application/json`) | OK |
| `400` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`application/problem+json`) | Invalid or unknown parameter. |
| `401` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`application/problem+json`) | Missing, invalid or inactive API key (code unauthorized), or a refused access token (code invalid_token: malformed, unknown key, bad signature, expired, wrong issuer or audience, revoked grant). WWW-Authenticate names the protected-resource metadata (RFC 9728). |
| `503` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`application/problem+json`) | Database unavailable; retry after the Retry-After delay. |
| `default` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`application/problem+json`) | Any other error (405, 500, 504). |

## Response body

A `200` carries a [ReportList](https://www.secblast.com/docs/reference/schemas#schema-reportlist) object.

| Field | Type | Required | Description |
|---|---|---|---|
| `data` | array of [Report](https://www.secblast.com/docs/reference/schemas#schema-report) | yes |   |
| `has_more` | boolean | yes |   |
| `next_cursor` | string \| null | yes |   |
| `snapshot` | [Snapshot](https://www.secblast.com/docs/reference/schemas#schema-snapshot) | yes |   |

## Example request

```bash
curl -sS -H "Authorization: Bearer $SECBLAST_API_KEY" \
  'https://api.secblast.com/v3/reports?cik=320193'
```

The entity in this example is only an illustration.

[Open this route in the console](https://www.secblast.com/console#get-v3-reports)

## More in Filings

Previous: [`GET /v3/filings/{accession}/versions`](https://www.secblast.com/docs/reference/get-filings-accession-versions)
