Skip to content

GET /v3/companies/{cik}/statements

A company's statement as presented in its latest periodic report (10-K, 10-Q, 10-KT, 10-QT, 20-F, 40-F and amendments) SEC had accepted by as_of that has one: of one kind (with its parentheticals), of one menu category (notes, details, ...) or one role URI; limit > 1 gives the previous reports' too, newest first. Each report's statements are paged as on /v3/filings/{accession}/statements (has_more; links.next continues there). A category without kind or role_uri names one report (limit 1): its roles are paged here, with has_more and next_cursor. Deleted (SEC-withdrawn) reports are skipped (the previous report is served) and the ones the answer would have read are named in excluded.

API key: required. See Authentication.

Group: Financial data (XBRL)

Parameters

NameInTypeRequiredDefaultDescription
cikpathstringyesThe company's CIK (the filing's primary filer), padded or unpadded.
kindquerystringnoBS, IS, CF, EQ, CI, CP or UN. Required unless category or role_uri is given. One of: BS, IS, CF, EQ, CI, CP, UN.
categoryquerystringnoThe role's menu category as SEC's FilingSummary states it, any letter case: Cover, Statements, Notes, Policies, Tables, Details, Other or Uncategorized (notes, policies, tables and details are served like statements).
role_uriquerystringnoOnly the role with this URI (roles[].role_uri), e.g. a company's own detail role.
as_ofquerystringnoInclusive: YYYY-MM-DDTHH:MM:SSZ (UTC, through the end of that second), YYYY-MM-DDTHH:MM:SS.ffffffZ (exact) or YYYY-MM-DD (the whole UTC day). Against each incarnation's filing acceptance time.
limitqueryintegerno1Reports, 1..8 (1 with a category alone).
cursorquerystringnonext_cursor of the previous page (a category alone; same filters).

Responses

StatusBodyDescription
200XbrlCompanyStatements (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 XbrlCompanyStatements object.

FieldTypeRequiredDescription
as_ofstring | nullyes
categorystring | nullyes
cikstringyes
dataarray of objectyes
data[].accessionstringno
data[].filingobjectnoWith links.next: the filing route's next page of this report.
data[].has_morebooleanno
data[].statementsarray of XbrlStatementno
excludedExcludedyes
excluded_totalintegeryes
has_morebooleanyesA category alone: the report's next roles (next_cursor).
kindstring | nullyes
next_cursorstring | nullyes
role_uristring | nullyes

Example request

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

The entity in this example is only an illustration.

Open this route in the console

More in Financial data (XBRL)

Previous: GET /v3/companies/{cik}/standard · Next: GET /v3/filings/{accession}/facts

Markdown version: /docs/reference/get-companies-cik-statements.md