# GET /v3/resolve

Which CIK(s) hold a ticker, from SEC's ticker file; with as_of, from the copy that was current on that date. Empty data when the ticker is unknown, the date precedes coverage_from, or the snapshot store is unavailable.

**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 |
|---|---|---|---|---|---|
| `ticker` | query | string | yes |   | Ticker symbol (case-insensitive): 1 to 16 letters, digits, '.' or '-'. Required. |
| `as_of` | query | date (YYYY-MM-DD) | no |   | Date to resolve on, YYYY-MM-DD. Default: the newest copy. |

## Responses

| Status | Body | Description |
|---|---|---|
| `200` | [ResolveResult](https://www.secblast.com/docs/reference/schemas#schema-resolveresult) (`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). |
| `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 [ResolveResult](https://www.secblast.com/docs/reference/schemas#schema-resolveresult) object.

| Field | Type | Required | Description |
|---|---|---|---|
| `as_of` | date (YYYY-MM-DD) \| null | no |   |
| `coverage_from` | date (YYYY-MM-DD) \| null | no | The oldest copy kept; earlier dates cannot be resolved. |
| `data` | array of [ResolveMatch](https://www.secblast.com/docs/reference/schemas#schema-resolvematch) | yes |   |
| `file_date` | date (YYYY-MM-DD) \| null | no | The daily copy of SEC's ticker file that answered. |
| `has_more` | boolean | no |   |
| `next_cursor` | string \| null | no |   |
| `snapshot` | [Snapshot](https://www.secblast.com/docs/reference/schemas#schema-snapshot) | yes | available is false when the store could not be asked, or had neither a ticker file nor a snapshot to consult: empty data then means unknown, not that no entity holds the ticker. |
| `source` | string \| null | no | One of: `sec_company_tickers`, `submissions`, `null`. |
| `ticker` | string | yes |   |

## Example request

```bash
curl -sS -H "Authorization: Bearer $SECBLAST_API_KEY" \
  'https://api.secblast.com/v3/resolve?ticker=AAPL'
```

The entity in this example is only an illustration.

[Open this route in the console](https://www.secblast.com/console#get-v3-resolve)

## More in Entities

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