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.
Group: 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 (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). |
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 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 | 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 | 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
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
More in Entities
Previous: GET /v3/entities/{cik}/filings
Markdown version: /docs/reference/get-resolve.md