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
| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
cik | path | string | yes | CIK, padded or unpadded. |
Responses
| Status | Body | Description |
|---|---|---|
200 | Entity (application/json) | OK |
400 | Problem (application/problem+json) | Invalid or unknown parameter. |
401 | Problem (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). |
404 | Problem (application/problem+json) | Not found. |
503 | Problem (application/problem+json) | Database unavailable; retry after the Retry-After delay. |
default | Problem (application/problem+json) | Any other error (405, 500, 504). |
Response body
A 200 carries a Entity object.
| Field | Type | Required | Description |
|---|---|---|---|
addresses | Addresses | no | |
as_of | object | null | no | The filing the as-filed attributes come from; null when v3 has no filing for the CIK. |
as_of.accession | string | no | |
as_of.filing_date | date (YYYY-MM-DD) | no | |
as_of.role | string | no | |
cik | string | no | |
current | EntityCurrent | no | |
data | null | no | Present (null) only in the {cik, data, snapshot} body described above. |
filings | integer | no | Filings in v3 that name the entity. |
first_filing_date | date (YYYY-MM-DD) | null | no | |
fiscal_year_end | string | null | no | |
former_names | array of object | no | |
irs_number | string | null | no | |
last_filing_date | date (YYYY-MM-DD) | null | no | |
links | object | no | |
links.filings | string | no | |
links.sec_filings | string | no | |
links.self | string | no | |
name | string | null | no | |
role_counts | object | no | |
roles | array of string | no | |
sic | string | null | no | |
snapshot | Snapshot | no | |
spac | Spac | no | |
state_of_inc | string | null | no |
Example request
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