---
title: "Search symbols"
method: GET
path: "/api/lookup/search"
tags: ["Symbol Lookup"]
---

# Search symbols

`GET /api/lookup/search`

![Free](https://img.shields.io/badge/Free-22c55e) ![Starter](https://img.shields.io/badge/Starter-3b82f6) ![Stock](https://img.shields.io/badge/Stock-f97316) ![ETF](https://img.shields.io/badge/ETF-14b8a6) ![Pro](https://img.shields.io/badge/Pro-8b5cf6)

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.

## Query parameters

- `searchString` string, required
- `type` 'stock' | 'etf' | 'mf' | 'cef' | 'fund' — Security type. | Value | Meaning | |-------|---------| | `stock` | Operating company. | | `etf` | Exchange-traded fund. | | `mf` | Open-end mutual fund. Includes an open-end fund that also offers an exchange-traded share class. | | `cef` | Closed-end fund. Exchange-listed like an ETF, but with fixed capital (SEC form N-2). | | `fund` | A registered fund whose kind is not yet evidenced — typically a series that has not filed its first N-CEN and has no listing. |
- `exchange` string
- `sector` string
- `includeDelisted` boolean
- `limit` integer

## Response `200`

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

- SymbolSearchResult[]
  - `symbol` string, nullable — Ticker symbol if available. Null for entities not listed anymore.
  - `exchange` string, nullable — Exchange this ticker is listed on. Null for entity-only matches (see symbol).
  - `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` 'stock' | 'etf' | 'mf' | 'cef' | 'fund' — Security type
  - `sector` string, nullable — Business sector derived from SIC code
  - `industry` string, nullable — Industry derived from SIC code
  - `industryGroup` string, nullable — High-value industry group, or null
  - `compositeFigi` string, nullable — Bloomberg Composite FIGI
  - `ein` integer, nullable — Employer Identification Number
  - `formerNames` string[] — Historical company names
  - `status` 'operating' | 'delisted' — 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`.
  - `priorTickers` 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.
    - `symbol` string — The former ticker on this venue
    - `exchange` string — The exchange the entity has since left
    - `lastSeen` string, date, nullable — 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.

## Other responses

- `400` — Invalid search string
- `403` — Feature not available on current plan

---

[API](https://skmtc.net/stockfit/apis/stockfit-api.md) · [All operations](https://skmtc.net/stockfit/apis/stockfit-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stockfit/stockfit-api/revisions/3d5897270d8a/schema)
