Skip to content

GET /v3/filings

Search filings. Keyset pagination: pass next_cursor back as cursor with the same filters and sort. Deleted (withdrawn) filings are listed like any other, with status deleted; status=final,provisional leaves them out. q and role need cik or a filing-date window (filed_from and filed_to, at most 92 days apart): 400 otherwise. sort=accepted_at lists filings by the acceptance time stored in v3 (accepted_at, exact to the stored fraction of a second; ties by accession), from the database alone: pages are complete and has_more is exact. Filings without an acceptance time are not listed. With cik the entity's filings are read in time order from its own index. A cursor issued before acceptance times were stored in v3 is refused (400): start the listing again.

API key: required. See Authentication.

Group: Filings

Parameters

NameInTypeRequiredDefaultDescription
cikquerystringnoCIK in any entity role, padded or unpadded. Combined with role and q on the same entity.
rolequerystringnoEntity role to match (with cik and/or q, or alone). Without cik it requires filed_from and filed_to at most 92 days apart (400 otherwise). One of: filer, subject, filed_by, filed_for, reporting_owner, issuer, depositor, securitizer, issuing_entity, underwriter, serial_company.
formquerycomma-separated list of stringnoBase form(s), exact, e.g. 10-K or 8-K,10-Q. Matches amendments too unless amendments=exclude.
amendmentsquerystringnoincludeWhether to include amendments. One of: include, exclude, only.
form_typequerycomma-separated list of stringnoExact form type(s) as filed, e.g. 10-K/A.
filed_fromquerydate (YYYY-MM-DD)nofiling_date >= this date (inclusive).
filed_toquerydate (YYYY-MM-DD)nofiling_date <= this date (inclusive).
feed_fromquerydate (YYYY-MM-DD)nofeed_date >= this date (inclusive).
feed_toquerydate (YYYY-MM-DD)nofeed_date <= this date (inclusive).
itemsquerycomma-separated list of stringnoItem codes (e.g. 2.02,9.01); a filing matches when it has any of them.
statusquerycomma-separated list of stringnoFiling status(es), e.g. final or final,provisional. Default: every status, deleted filings included.
accepted_fromquerystringnoAcceptance time >= this: YYYY-MM-DDTHH:MM:SSZ (UTC) or YYYY-MM-DD. Requires sort=accepted_at.
accepted_toquerystringnoAcceptance time <= this (inclusive; a date means the whole UTC day): YYYY-MM-DDTHH:MM:SSZ or YYYY-MM-DD. Requires sort=accepted_at.
qquerystringnoCase-insensitive substring of an entity name as filed. Without cik it requires filed_from and filed_to at most 92 days apart (400 otherwise): the name is tested filing by filing.
sortquerystringnofiling_dateSort key (ties broken by accession). One of: filing_date, accession, accepted_at.
orderquerystringnodescSort direction. One of: desc, asc.
limitqueryintegerno50Page size, 1..1000.
cursorquerystringnoOpaque cursor from a previous page's next_cursor. Must be used with the same filters, sort and order.

Responses

StatusBodyDescription
200FilingList (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).
503Problem (application/problem+json)Database unavailable.
defaultProblem (application/problem+json)Any other error (405, 500, 504).

Response body

A 200 carries a FilingList object.

FieldTypeRequiredDescription
dataarray of Filingyes
has_morebooleanyesTrue when another page follows (pages are complete for every sort).
next_cursorstring | nullyes
snapshotSnapshotyes

Example request

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

Open this route in the console

More in Filings

Next: GET /v3/filings/{accession}

Markdown version: /docs/reference/get-filings.md