---
title: "Symbol Lookup"
method: GET
path: "/search"
tags: ["Default"]
---

# Symbol Lookup

`GET /search`

Search for best-matching symbols based on your query. You can input anything from symbol, security's name to ISIN and Cusip.

## Query parameters

- `q` string, required
- `exchange` string

## Response `200`

successful operation

- SymbolLookup
  - `result` SymbolLookupInfo[] — Array of search results.
    - `description` string — Symbol description
    - `displaySymbol` string — Display symbol name.
    - `symbol` string — Unique symbol used to identify this symbol used in <code>/stock/candle</code> endpoint.
    - `type` string — Security type.
  - `count` integer — Number of results.

## Changes

- **2024-11-05** `fb7e94c545be` — 1 info
  - added the new optional `query` request parameter `exchange`
- **2021-07-26** `0f755a71e903` — 4 info
  - added the optional property `result/items/description` to the response with the `200` status
  - added the optional property `result/items/displaySymbol` to the response with the `200` status
  - added the optional property `result/items/symbol` to the response with the `200` status
  - added the optional property `result/items/type` to the response with the `200` status
- **2021-07-23** `a148c0b2d583` — 1 info
  - endpoint added
- **2020-05-26** `c5b8e420b78c` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/finnhub-stock-api/apis/finnhub-api/changes/search/get.md)

---

[API](https://skmtc.dev/finnhub-stock-api/apis/finnhub-api.md) · [All operations](https://skmtc.dev/finnhub-stock-api/apis/finnhub-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/finnhub-stock-api/finnhub-api/revisions/415b27331384/schema)