Skip to content

GET /v3/entities/{cik}

Most recent as-filed attributes of a CIK, SEC's current entity record from the snapshot (current), roles seen and filing counts. 404 when neither v3 nor the snapshot knows the CIK; when this deployment has no snapshot store configured, 404 whenever v3 has no filing for the CIK (v3 is then the only source). When a configured snapshot store is unavailable and v3 has no filing for the CIK the answer is 200 {cik, data: null, snapshot}: it cannot be told.

API key: required. See Authentication.

Group: Entities

Parameters

NameInTypeRequiredDefaultDescription
cikpathstringyesCIK, padded or unpadded.

Responses

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

FieldTypeRequiredDescription
addressesAddressesno
as_ofobject | nullnoThe filing the as-filed attributes come from; null when v3 has no filing for the CIK.
as_of.accessionstringno
as_of.filing_datedate (YYYY-MM-DD)no
as_of.rolestringno
cikstringno
currentEntityCurrentno
datanullnoPresent (null) only in the {cik, data, snapshot} body described above.
filingsintegernoFilings in v3 that name the entity.
first_filing_datedate (YYYY-MM-DD) | nullno
fiscal_year_endstring | nullno
former_namesarray of objectno
irs_numberstring | nullno
last_filing_datedate (YYYY-MM-DD) | nullno
linksobjectno
links.filingsstringno
links.sec_filingsstringno
links.selfstringno
namestring | nullno
role_countsobjectno
rolesarray of stringno
sicstring | nullno
snapshotSnapshotno
spacSpacno
state_of_incstring | nullno

Example request

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

The entity in this example is only an illustration.

Open this route in the console

More in Entities

Previous: GET /v3/entities · Next: GET /v3/entities/{cik}/filings

Markdown version: /docs/reference/get-entities-cik.md