---
title: "Find companies by name or ticker, forgiving typos."
method: GET
path: "/api/v1/search"
---

# Find companies by name or ticker, forgiving typos.

`GET /api/v1/search`

## Request

- Base URL: `https://tickerfacts.com`
- URL: `https://tickerfacts.com/api/v1/search`
- Auth: one of:
  - none
  - HTTP bearer

## Query parameters

- `query` string, required
- `limit` integer

## Response `200`

Best matches first, with ticker, CIK, listing status and latest annual period.

- CompanySearch
  - `count` integer, required
  - `note` string
  - `query` string, required
  - `results` object[], required
    - `cik` integer, required
    - `exchange` string, nullable
    - `industry` string, nullable
    - `latest_period_end` string, nullable
    - `listing_status` 'current' | 'former', required
    - `matched` 'ticker' | 'name' | 'similar', required
    - `name` string, required
    - `sector` string, nullable
    - `ticker` string, required

## Other responses

- `404`: No such record in this build.

---

[API](https://skmtc.dev/tickerfacts/apis/tickerfacts-json-api.md) · [All operations](https://skmtc.dev/tickerfacts/apis/tickerfacts-json-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tickerfacts/apis/tickerfacts-json-api/revisions/bc6cb5e92b7f?raw)