Skip to content

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.

Group: Filings

Parameters

NameInTypeRequiredDefaultDescription
cikquerystringyesPrimary CIK of the report, padded or unpadded. Required.
formquerycomma-separated list of stringnoBase form(s) of the chain's first filing, exact, e.g. 10-K or 10-K,10-Q.
periodquerydate (YYYY-MM-DD)noOnly chains whose first filing has this period_of_report.
limitqueryintegerno50Page size, 1..200.
cursorquerystringnoOpaque cursor from a previous page's next_cursor. Must be used with the same filters.

Responses

StatusBodyDescription
200ReportList (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; retry after the Retry-After delay.
defaultProblem (application/problem+json)Any other error (405, 500, 504).

Response body

A 200 carries a ReportList object.

FieldTypeRequiredDescription
dataarray of Reportyes
has_morebooleanyes
next_cursorstring | nullyes
snapshotSnapshotyes

Example request

Shell
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

More in Filings

Previous: GET /v3/filings/{accession}/versions

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