# CIK, CUSIP and Ticker Mapping API Reference | SEC API

> Complete API reference for the SEC API Mapping API. Resolve a ticker, CIK, CUSIP or company name to a company profile, with every path parameter and every response attribute, types and a live example response.

Source: https://sec-api.io/api-reference/cik-cusip-ticker-lookup

Identifiers and entities

GET`https://api.sec-api.io/mapping/{resolveBy}/{value}`

Resolve a ticker, CIK, CUSIP or company name to a standardised company profile holding the name, CIK, CUSIPs, exchange, sector, industry, SIC classification, currency and headquarters location. The same endpoint also lists every company on an exchange, in a sector or in an industry, and it covers listed and delisted US securities.

[Read the guide for this API →](https://sec-api.io/docs/mapping-api)

## Authentication

Send the API key either as a header or as a query parameter. The header is preferred; the query parameter exists for cases where a header cannot be set, such as opening a URL directly in a browser.

Authorization: required header

The API key on its own. Do not prefix it with Bearer or any other word.

Example `Authorization: YOUR_API_KEY`

token: optional query parameter

The API key, appended to the URL. Use this only when a header is not possible.

## Path parameters

Supplied as part of the URL.

resolveBy: required string

The identifier type to resolve by. One of cik, ticker, cusip, name, exchange, sector or industry. Any other value is rejected with 400.

Example `ticker`

value: required string, Maximum 400 characters

The identifier or label to look up, for example TSLA, 1318605, 88160R101, Tesla, NASDAQ, Technology or Auto Manufacturers. Upper case and lower case are treated the same, so Tesla and tesla return the same result. URL-encode the value when it holds spaces or other reserved characters.

Example `TSLA`

## Response

A JSON object. Nested attributes are collapsed; expand one to see its fields.

[ ]: array of object

The response body is a JSON array with no wrapper object. Each item is one company record that matches the lookup. The array holds several items when the value maps to more than one security, for example several share classes under one CIK. It is empty when nothing matches.

name: string

Name of the company, for example TESLA INC.

ticker: string

Ticker symbol of the company, for example TSLA.

cik: string

CIK of the company, with leading zeros removed.

cusip: string

One or more CUSIPs linked to the company. Several CUSIPs are separated by a space, for example 054748108 92931L302 92931L401. An empty string when no CUSIP is known, which happens for records that are not tradeable securities.

exchange: string

Main exchange the company is listed on. Values are NYSE, NASDAQ, NYSEMKT, NYSEARCA, OTC, BATS and INDEX. An empty string when the record carries no exchange.

isDelisted: boolean

true when the company is no longer listed, false otherwise. One ticker can resolve to a listed record and to delisted records that used the same symbol.

category: string

Security category, for example Domestic Common Stock, Domestic Common Stock Primary Class or Domestic Preferred Stock.

sector: string

Sector of the company. Values are Technology, Communication Services, Healthcare, Consumer Cyclical, Consumer Defensive, Basic Materials, Financial Services, Industrials, Real Estate, Energy and Utilities.

industry: string

Industry of the company, for example Auto Manufacturers or Banks - Regional.

sic: string

Four-digit SIC code of the company, for example 3711.

sicSector: string

SIC sector name of the company, for example Manufacturing.

sicIndustry: string

SIC industry name of the company, for example Motor Vehicles & Passenger Car Bodies.

famaSector: optional string

Fama-French sector name of the company. Often an empty string because the source data sets it for a subset of companies only.

famaIndustry: optional string

Fama-French industry name of the company, for example Automobiles and Trucks.

currency: string

Operating currency of the company, for example USD.

location: string

Location of the headquarters of the company, for example California; U.S.A.

id: string

Unique internal id of the company record, for example eaeafc4ffc04a49da153adebf1f6960a.

## Status codes

|  |  |
| --- | --- |
| `200` | Success. The body is an array of company records. A value that matches nothing returns 200 with an empty array, not an error. |
| `400` | resolveBy is not one of the supported identifier types, or value is longer than 400 characters. |
| `403` | The API key is missing, or it is not valid. |
| `429` | Too many requests. Slow the request rate and retry. |
| `500` | Server error. Retry, and report it if it persists. |

## Request example

GET https://api.sec-api.io/mapping/{resolveBy}/{value}

```bash
GET https://api.sec-api.io/mapping/ticker/TSLA
```

```python
from sec_api import MappingApi

mappingApi = MappingApi("YOUR_API_KEY")

result = mappingApi.resolve("ticker", "TSLA")
```

```javascript
import { mappingApi } from "sec-api";

mappingApi.setApiKey("YOUR_API_KEY");

const result = await mappingApi.resolve("ticker", "TSLA");
```

```bash
curl -X GET "https://api.sec-api.io/mapping/ticker/TSLA" \
  -H "Authorization: YOUR_API_KEY"
```

## Response example

200 OK · application/json

```json
[
  {
    "name": "TESLA INC",
    "ticker": "TSLA",
    "cik": "1318605",
    "cusip": "88160R101",
    "exchange": "NASDAQ",
    "isDelisted": false,
    "category": "Domestic Common Stock",
    "sector": "Consumer Cyclical",
    "industry": "Auto Manufacturers",
    "sic": "3711",
    "sicSector": "Manufacturing",
    "sicIndustry": "Motor Vehicles & Passenger Car Bodies",
    "famaSector": "",
    "famaIndustry": "Automobiles and Trucks",
    "currency": "USD",
    "location": "California; U.S.A",
    "id": "eaeafc4ffc04a49da153adebf1f6960a"
  }
]
```