# 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](https://www.secblast.com/docs/authentication).

**Group:** [Entities](https://www.secblast.com/docs/reference#entities)

## Parameters

| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
| `cik` | path | string | yes |   | CIK, padded or unpadded. |

## Responses

| Status | Body | Description |
|---|---|---|
| `200` | [Entity](https://www.secblast.com/docs/reference/schemas#schema-entity) (`application/json`) | OK |
| `400` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`application/problem+json`) | Invalid or unknown parameter. |
| `401` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-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](https://www.secblast.com/docs/reference/schemas#schema-problem) (`application/problem+json`) | Not found. |
| `503` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`application/problem+json`) | Database unavailable; retry after the Retry-After delay. |
| `default` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`application/problem+json`) | Any other error (405, 500, 504). |

## Response body

A `200` carries a [Entity](https://www.secblast.com/docs/reference/schemas#schema-entity) object.

| Field | Type | Required | Description |
|---|---|---|---|
| `addresses` | [Addresses](https://www.secblast.com/docs/reference/schemas#schema-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](https://www.secblast.com/docs/reference/schemas#schema-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](https://www.secblast.com/docs/reference/schemas#schema-snapshot) | no |   |
| `spac` | [Spac](https://www.secblast.com/docs/reference/schemas#schema-spac) | no |   |
| `state_of_inc` | string \| null | no |   |

## Example request

```bash
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](https://www.secblast.com/console#get-v3-entities-cik)

## More in Entities

Previous: [`GET /v3/entities`](https://www.secblast.com/docs/reference/get-entities) · Next: [`GET /v3/entities/{cik}/filings`](https://www.secblast.com/docs/reference/get-entities-cik-filings)
