Fincoded
 Log In Sign Up

Master Securities List API

Company Security Information and Identifiers

All 8,000+ public companies that file with the SEC
Updated weekly
Jump to: API Endpoint Request Parameters Response Data Model Response Example References

The Master Securities List API endpoint provides developers with a simple interface to search for companies and securities by various identifiers used in SEC data – CIK, CUSIP, ticker - so that data can be mapped and normalized between individual data sets. The API returns structured JSON data for easy integration into your application.

API Endpoint

https://api.fincoded.com/v1/master-securities-list

Supported HTTP methods: GET
Response content type: JSON

Use the API key on your user dashboard to authenticate your requests, using the key=[YOUR_API_KEY] query parameter:

https://api.fincoded.com/v1/master-securities-list?key=[YOUR_API_KEY]

Request Parameters

You can query the endpoint by any Master Securities List property; see the Response Data Model below for a full list of available properties.

Request Parameters
Standard query parameters, all optional. See the API introduction for more details.
  • property[operator]value: Filter the data based on various data model properties, operators (=, <=, >=, !=, <, >) and values.
  • page: The page number for the set of results you want to retrieve.
  • count: The number of results per page.
  • sortBy: The field you want to sort the results by, in full dotted JSON path syntax.
  • sortOrder: The order you want to sort the results, asc for ascending and desc for descending order.
  • subdocuments: When set to true, for endpoints that contain subdocuments for each result (eg informationTable holdings in 13F data), limit these subdocuments to those that match the subdocument filter conditions.
Request Examples

Return all companies (and their securities) that have a CIK of 320193 (Apple) or 789019 (Microsoft).

https://api.fincoded.com/v1/master-securities-list?cik=320193,789019

Return all companies (and their securities) that have a ticker of GOOG.

https://api.fincoded.com/v1/master-securities-list?securities.ticker=GOOG

Response Data Model

Response type: JSON

The data model for each returned item represents company/issuer information at the top level, with one or more securities as child properties.

Property Type Enum Values Path
cik string cik
name string name
sic string sic
securities object[] securities
ticker string securities.ticker
exchange string securities.exchange
cusip string securities.cusip
name string securities.name

Response Example

{
  "data": [
    {
      "cik": "1957783",
      "name": "MachTen, Inc.",
      "securities": [
        {
          "ticker": "MACT",
          "exchange": "OTC",
          "cusip": "55449T109"
        }
      ]
    },
    {
      "cik": "1953988",
      "name": "WEB3 Corp",
      "securities": [
        {
          "ticker": "WEBT",
          "exchange": "OTC",
          "cusip": "860914100"
        }
      ]
    },
    {
      "cik": "1951378",
      "name": "Qilun Group Inc.",
      "securities": [
        {
          "ticker": "QLUNF",
          "exchange": "OTC"
        }
      ]
    },
    {
      "cik": "1941189",
      "name": "Tian'an Technology Group Ltd",
      "securities": [
        {
          "ticker": "TANAF",
          "exchange": "OTC"
        }
      ]
    },
    {
      "cik": "1938338",
      "name": "GlobalTech Corp",
      "securities": [
        {
          "ticker": "GLTK",
          "exchange": "OTC"
        }
      ]
    },
    {
      "cik": "1933644",
      "name": "Medlive Technology Co., Ltd./ADR",
      "securities": [
        {
          "ticker": "MDLVY",
          "exchange": "OTC"
        }
      ]
    },
    {
      "cik": "1931055",
      "name": "Medinotec Inc.",
      "securities": [
        {
          "ticker": "MDNC",
          "exchange": "OTC"
        }
      ]
    },
    {
      "cik": "1921332",
      "name": "AZTECH GLOBAL LTD./ADR",
      "securities": [
        {
          "ticker": "AZTGY",
          "exchange": "OTC"
        }
      ]
    },
    {
      "cik": "1919182",
      "name": "Eco Bright Future, Inc.",
      "securities": [
        {
          "ticker": "EBFI",
          "exchange": "OTC"
        }
      ]
    },
    {
      "cik": "1918884",
      "name": "Metaterra Corp.",
      "securities": [
        {
          "ticker": "MTRC",
          "exchange": "OTC"
        }
      ]
    }
  ],
  "metadata": {
    "total": 8387,
    "count": 10,
    "page": 1,
    "pages": 839
  }
}

References

Find out more about alternative Master Securities Lists: