Search symbols

GET/api/lookup/search

Fuzzy-matches company name or ticker symbol, ranked by relevance. Returns enriched profiles with sector, industry, description, and logo. Covers stocks, ETFs, and mutual funds.

Get API key Try it live in the API explorer

Query parameters

searchString string required min length 2 · max length 50

Search term (name or ticker). Alphanumeric characters, dots, hyphens, and spaces allowed.

Example: Apple
type string (enum) optional

Filter by security type
exchange string optional

Filter by exchange

Example: NASDAQ
sector string optional

Filter by business sector

Example: Technology
includeDelisted boolean optional default false

Include delisted symbols in results
limit integer optional min 1 · max 100 · default 25

Maximum number of results

Example request

curl 'https://api.stockfit.io/v1/api/lookup/search?searchString=Apple&exchange=NASDAQ&sector=Technology' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

Responses

200 OK

Matching tickers ranked by relevance. A multi-class issuer (e.g. Alphabet) returns one result per active ticker (GOOG and GOOGL separately).

Response schema

array of:

symbol string
Ticker symbol
exchange string
Exchange this ticker is listed on
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 derived from SIC code
industryGroup string | null
High-value industry group, or null
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 (fully dark, including OTC). A name still trading OTC after leaving a major reads `operating`.
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. 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 search string

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

{}