Lookup by symbol

GET/api/lookup/symbol

Returns enriched profile (name, CIK, exchange, sector, industry, description, logo) for a given ticker symbol.

Get API key Try it live in the API explorer

Query parameters

symbol string optional min length 1 · max length 10

Stock ticker symbol. Identify the entity by exactly one of: symbol, cik, cusip, composite_figi, or share_class_figi. At least one is required.

Example: AAPL
cik integer optional

SEC Central Index Key (CIK).

Example: 320193
cusip string optional min length 9 · max length 9

CUSIP identifier (9 characters).

Example: 037833100
composite_figi string optional

Composite OpenFIGI identifier.

Example: BBG000B9XRY4
share_class_figi string optional

Share-class OpenFIGI identifier.

Example: BBG001S5N8V8

Example request

curl 'https://api.stockfit.io/v1/api/lookup/symbol?symbol=AAPL&cik=320193&cusip=037833100&composite_figi=BBG000B9XRY4&share_class_figi=BBG001S5N8V8' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

Responses

200 OK

Symbol profile

Response schema

symbols array of string
Tickers of the entity's currently active listings, primary first. Positionally aligned with `exchanges` (symbols[i] trades on exchanges[i]); not deduplicated, so a multi-class issuer lists every class.
exchanges array of string
Exchange for each ticker in `symbols`, in the same order. Not deduplicated.
name string
Company or fund name
cik integer
SEC Central Index Key
seriesId integer
Series ID (0 for stocks, non-zero for ETF/mutual fund series sharing a CIK)
type string (enum)
Security type
Allowed values: stock, etf, mf
sector string | null
Business sector derived from SIC code
industry string | null
Industry classification derived from SIC code
industryGroup string | null
High-value industry group (Semiconductors, Software & SaaS, Pharma & Biotech, Aerospace & Defense, Automotive, Airlines, Oil & Gas, Fintech & Payments). Null if company is not in one of these groups.
compositeFigi string | null
Bloomberg Composite FIGI
ein integer | null
Employer Identification Number
formerNames array of string
Historical company names
status string (enum)
Operating status. `delisted` ONLY when the entity has no active listing left on ANY exchange (it has gone fully dark and no longer trades anywhere we track, including OTC). A company that left a major exchange but still trades over-the-counter reads `operating`; see `priorTickers` for the listings it has left behind.
Allowed values: operating, delisted
priorTickers array of object
Listings the entity no longer trades on (delisted), e.g. a Nasdaq listing left behind after a move to OTC. The currently active listings are in `symbols`/`exchanges`. Empty for entities that never left a listing.
array of:
- symbol string
  The former ticker on this venue
- exchange string
  The exchange the entity has since left
- lastSeen string (date) | null
  The most recent date (ISO 8601) this former ticker was confirmed active — its last-seen date, i.e. roughly when the entity stopped trading under it. For a clean ticker rename (no SEC Form 25/15 removal filing) this approximates the switchover and may be a recent period-end rather than the exact change date. Null when unknown.

Example response

{}

400 Bad Request

Invalid parameters or symbol not found

Response schema

error string
Human-readable error message

Example response

{}

403 Forbidden

Feature not available on current plan

Response schema

error string
Human-readable error message

Example response

{}