Skip to content

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

NameInTypeRequiredDefaultDescription
tickerquerystringyesTicker symbol (case-insensitive): 1 to 16 letters, digits, '.' or '-'. Required.
as_ofquerydate (YYYY-MM-DD)noDate to resolve on, YYYY-MM-DD. Default: the newest copy.

Responses

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

FieldTypeRequiredDescription
as_ofdate (YYYY-MM-DD) | nullno
coverage_fromdate (YYYY-MM-DD) | nullnoThe oldest copy kept; earlier dates cannot be resolved.
dataarray of ResolveMatchyes
file_datedate (YYYY-MM-DD) | nullnoThe daily copy of SEC's ticker file that answered.
has_morebooleanno
next_cursorstring | nullno
snapshotSnapshotyesavailable 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.
sourcestring | nullnoOne of: sec_company_tickers, submissions, null.
tickerstringyes

Example request

Shell
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