Skip to content

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

NameInTypeRequiredDefaultDescription
cikpathstringyesCIK, padded or unpadded.
formquerycomma-separated list of stringnoExact form type(s), e.g. 10-K or 8-K,8-K/A.
filed_fromquerydate (YYYY-MM-DD)nofiling_date >= this date (inclusive).
filed_toquerydate (YYYY-MM-DD)nofiling_date <= this date (inclusive).
limitqueryintegerno50Page size, 1..1000.
offsetqueryintegerno0Rows to skip, 0..100000000.

Responses

StatusBodyDescription
200SecFilingList (application/json)OK
400Problem (application/problem+json)Invalid or unknown parameter.
401Problem (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).
404Problem (application/problem+json)Not found.
503Problem (application/problem+json)Database unavailable; retry after the Retry-After delay.
defaultProblem (application/problem+json)Any other error (405, 500, 504).

Response body

A 200 carries a SecFilingList object.

FieldTypeRequiredDescription
dataarray of SecFilingyes
has_morebooleanno
next_cursorstring | nullnoAlways null: this list is paged with offset; use next_offset.
next_offsetinteger | nullnoThe offset of the next page; null on the last page (and when the snapshot store is unavailable).
offsetintegerno
snapshotSnapshotyes
totalinteger | nullnoRows matching the filters; null when the snapshot store is unavailable.

Example request

Shell
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