Identifiers and entities
CIK, CUSIP and Ticker Mapping
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.
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
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. |