Mapping API
The Mapping API resolves a ticker symbol, CIK, CUSIP or company name to a set of standardized company details. The API is used for mapping between different identifiers and company information and covers currently listed and delisted companies on US exchanges.
Company information includes a variety of identifiers and attributes, such as the ticker symbol, CIK, and CUSIPs, along with additional details like the exchange where the company is listed, its sector and industry, SIC code, headquarters location, security category, and the currency in which the security is traded.
API Endpoints
Mapping Endpoints
Seven Mapping API endpoints are available for mapping and retrieving company details by CIK, ticker, CUSIP, company name, exchange, sector, and industry. Each endpoint maps a specific identifier to company details and returns an array of companies matching the search criteria. For example, mapping a ticker to company details returns an array of listed and delisted companies that trade or traded under the ticker symbol.
Base URL For All Mapping Endpoints:
Supported HTTP methods: GET
Response format: JSON
API Endpoints:
Choose one of the following endpoints to map a CIK, ticker, CUSIP, and other parameters to company details. Add the base URL https://api.sec-api.io/mapping
at the beginning of the specified endpoint.
Endpoint | Description | HTTP Method | Response Format |
---|---|---|---|
/cik/<CIK> | Map a CIK to company details | GET | JSON |
/ticker/<TICKER> | Map a ticker to company details | GET | JSON |
/cusip/<CUSIP> | Map a CUSIP to company details | GET | JSON |
/name/<NAME> | Map a company name to company details | GET | JSON |
/exchange/<EXCHANGE> | List all companies on a given exchange | GET | JSON |
/sector/<SECTOR> | List all companies operating in a given sector | GET | JSON |
/industry/<INDUSTRY> | List all companies operating in one of 175 industries | GET | JSON |
Example URLs:
https://api.sec-api.io/mapping/cik/1318605
https://api.sec-api.io/mapping/ticker/TSLA
https://api.sec-api.io/mapping/cusip/88160R101
Bulk Download Mapping Files
The bulk download endpoints provide access to complete JSON files containing full mappings between various identifiers. These files are updated daily between 1:00 AM and 5:00 AM and include both active and inactive entities.
Endpoint | Description | HTTP Method | Response Format |
---|---|---|---|
/bulk/mapping/cik-to-ticker | JSON file with all CIK-to-ticker mappings | GET | JSON |
/bulk/mapping/cik-to-cusip | JSON file with all CIK-to-CUSIP mappings | GET | JSON |
/bulk/mapping/ticker-to-cik | JSON file with all ticker-to-CIK mappings | GET | JSON |
/bulk/mapping/ticker-to-cusip | JSON file with all ticker-to-CUSIP mappings | GET | JSON |
/bulk/mapping/cusip-to-cik | JSON file with all CUSIP-to-CIK mappings | GET | JSON |
/bulk/mapping/cusip-to-ticker | JSON file with all CUSIP-to-ticker mappings | GET | JSON |
Example URLs:
https://api.sec-api.io/bulk/mapping/cik-to-ticker
https://api.sec-api.io/bulk/mapping/cusip-to-cik
Authentication
The Mapping API supports two authentication strategies. Either set your API key as Authorization
header or attach your key as query parameter:
- Set as
Authorization
header. Before making aGET
request to any of the mapping endpoints, you need to set theAuthorization
header toYOUR_API_KEY
. - Set as query parameter. Example:
https://api.sec-api.io/mapping/cik/1318605?token=YOUR_API_KEY
In this case, performGET
requests to the endpointhttps://api.sec-api.io/mapping/cik/1318605?token=YOUR_API_KEY
and not tohttps://api.sec-api.io/mapping/cik/1318605
.
Response Format
Response format: JSON
Every API endpoint returns an array with companies matching your query. An array item has the following structure:
name
(string) - the name of the company, e.g. Tesla Incticker
(string) - the ticker symbol of the company.cik
(string) - the CIK of the company. Trailing zeros are removed.cusip
(string) - one or multiple CUSIPs linked to the company. Multiple CUSIPs are delimited by space, e.g."054748108 92931L302 92931L401"
exchange
(string) - the main exchange the company is listed on, e.g. NASDAQisDelisted
(boolean) -true
if the company is no longer listed,false
otherwise.category
(string) - the security category, e.g. "Domestic Common Stock"sector
(string) - the sector of the company, e.g. "Consumer Cyclical"industry
(string) - the industry of the company, e.g. "Auto Manufacturers"sic
(string) - four-digit SIC code, e.g. "3711"sicSector
(string) - SIC sector name of the company, e.g. "Manufacturing"sicIndustry
(string) - SIC industry name of the company, e.g. "Motor Vehicles & Passenger Car Bodies"currency
(string) - operating currency of the company, e.g. "USD"location
(string) - location of the company's headquartersid
(string) - unique internal ID of the company, e.g. "e27d6e9606f216c569e46abf407685f3"
Example
Request: GET
https://api.sec-api.io/mapping/ticker/TSLA?token=YOUR_API_KEY
Response:
1
[
2
{
3
"name": "Tesla Inc",
4
"ticker": "TSLA",
5
"cik": "1318605",
6
"cusip": "88160R101",
7
"exchange": "NASDAQ",
8
"isDelisted": false,
9
"category": "Domestic Common Stock",
10
"sector": "Consumer Cyclical",
11
"industry": "Auto Manufacturers",
12
"sic": "3711",
13
"sicSector": "Manufacturing",
14
"sicIndustry": "Motor Vehicles & Passenger Car Bodies",
15
"famaSector": "",
16
"famaIndustry": "Automobiles and Trucks",
17
"currency": "USD",
18
"location": "California; U.S.A",
19
"id": "e27d6e9606f216c569e46abf407685f3"
20
}
21
]
Structure of Bulk Downloaded Files
/bulk/mapping/cik-to-ticker
1
{
2
//
3
// key: CIK of EDGAR entity
4
// value: array of tickers
5
//
6
"7789": [
7
"ASB",
8
"ASB-PE",
9
"ASB.WS"
10
],
11
"8063": [
12
"ATRO",
13
"ATROB"
14
],
15
"8109": [
16
"ATPC1"
17
],
18
// ... more entries
19
}
/bulk/mapping/cik-to-cusip
1
{
2
//
3
// key: CIK of EDGAR entity
4
// value: array of CUSIPs
5
//
6
"1571996": [
7
"24703L202",
8
"24703L103"
9
],
10
// ... more entries
11
}
/bulk/mapping/ticker-to-cik
1
{
2
//
3
// key: ticker of EDGAR entity
4
// value: array of CIKs
5
//
6
"AAPL": [
7
"320193"
8
],
9
"MSFT": [
10
"789019"
11
],
12
// ... more entries
13
}
/bulk/mapping/ticker-to-cusip
1
{
2
//
3
// key: ticker of EDGAR entity
4
// value: array of CUSIPs
5
//
6
"DELL": [
7
"24703L202",
8
"24703L103"
9
],
10
"GOOG": [
11
"02079K107",
12
"38259P706"
13
],
14
"GOOGL": [
15
"02079K305",
16
"38259P508"
17
],
18
// ... more entries
19
}
/bulk/mapping/cusip-to-cik
1
{
2
//
3
// key: CUSIP of security
4
// value: array of CIKs
5
//
6
"02079K107": [
7
"1652044"
8
],
9
"38259P706": [
10
"1652044"
11
],
12
// ... more entries
13
}
/bulk/mapping/cusip-to-ticker
1
{
2
//
3
// key: CUSIP of security
4
// value: array of tickers
5
//
6
"02079K107": [
7
"GOOG"
8
],
9
"38259P706": [
10
"GOOG"
11
],
12
// ... more entries
13
}