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

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 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.

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

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 a GET request to any of the mapping endpoints, you need to set the Authorization header to YOUR_API_KEY.
• Set as query parameter. Example: https://api.sec-api.io/mapping/cik/1318605?token=YOUR_API_KEY
  In this case, perform GET requests to the endpoint https://api.sec-api.io/mapping/cik/1318605?token=YOUR_API_KEY and not to https://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 Inc
• ticker (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. NASDAQ
• isDelisted (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 headquarters
• id (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
            ]