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.
Group: 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 (application/json) | OK |
400 | Problem (application/problem+json) | Invalid or unknown parameter. |
401 | 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 (application/problem+json) | Not found. |
503 | Problem (application/problem+json) | Database unavailable; retry after the Retry-After delay. |
default | Problem (application/problem+json) | Any other error (405, 500, 504). |
Response body
A 200 carries a SecFilingList object.
| Field | Type | Required | Description |
|---|---|---|---|
data | array of 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 | yes | |
total | integer | null | no | Rows matching the filters; null when the snapshot store is unavailable. |
Example request
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
More in Entities
Previous: GET /v3/entities/{cik} · Next: GET /v3/resolve
Markdown version: /docs/reference/get-entities-cik-filings.md