# GET /v3/entities/{cik}/filings

SEC's own filing list for the entity (from the submissions snapshot), newest first; each row says whether v3 has the filing. 404 when the snapshot has no such CIK. Empty data with snapshot.available=false when the snapshot store is unavailable. Paged with offset (pass next_offset back as offset; next_cursor is always null): the list can shift when a new snapshot is loaded.

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

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

## Parameters

| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
| `cik` | path | string | yes |   | CIK, padded or unpadded. |
| `form` | query | comma-separated list of string | no |   | Exact form type(s), e.g. 10-K or 8-K,8-K/A. |
| `filed_from` | query | date (YYYY-MM-DD) | no |   | filing_date \>= this date (inclusive). |
| `filed_to` | query | date (YYYY-MM-DD) | no |   | filing_date \<= this date (inclusive). |
| `limit` | query | integer | no | `50` | Page size, 1..1000. |
| `offset` | query | integer | no | `0` | Rows to skip, 0..100000000. |

## Responses

| Status | Body | Description |
|---|---|---|
| `200` | [SecFilingList](https://www.secblast.com/docs/reference/schemas#schema-secfilinglist) (`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). |
| `404` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`application/problem+json`) | Not found. |
| `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 [SecFilingList](https://www.secblast.com/docs/reference/schemas#schema-secfilinglist) object.

| Field | Type | Required | Description |
|---|---|---|---|
| `data` | array of [SecFiling](https://www.secblast.com/docs/reference/schemas#schema-secfiling) | yes |   |
| `has_more` | boolean | no |   |
| `next_cursor` | string \| null | no | Always null: this list is paged with offset; use next_offset. |
| `next_offset` | integer \| null | no | The offset of the next page; null on the last page (and when the snapshot store is unavailable). |
| `offset` | integer | no |   |
| `snapshot` | [Snapshot](https://www.secblast.com/docs/reference/schemas#schema-snapshot) | yes |   |
| `total` | integer \| null | no | Rows matching the filters; null when the snapshot store is unavailable. |

## Example request

```bash
curl -sS -H "Authorization: Bearer $SECBLAST_API_KEY" \
  'https://api.secblast.com/v3/entities/320193/filings'
```

The entity in this example is only an illustration.

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

## More in Entities

Previous: [`GET /v3/entities/{cik}`](https://www.secblast.com/docs/reference/get-entities-cik) · Next: [`GET /v3/resolve`](https://www.secblast.com/docs/reference/get-resolve)
