v17

latestOpenAPI 3.0.1raw.githubusercontent.com2026-05-072674388.0 KB
v1

Companies

Browse or search for companies Perigon tracks using name, domain, ticker symbol, industry, and more. Supports Boolean search logic and filtering by metadata such as country, exchange, employee count, and IPO date.

get/v1/companies/all

Query parameters

idstring[]

String Array. Filter by unique company identifiers. Multiple values create an OR filter.

symbolstring[]

String Array. Filter by company stock ticker symbols (e.g., AAPL, MSFT, GOOGL). Multiple values create an OR filter.

domainstring[]

String Array. Filter by company domains or websites (e.g., apple.com, microsoft.com). Multiple values create an OR filter.

countrystring[]

String Array. Filter by company headquarters country. Multiple values create an OR filter.

exchangestring[]

String Array. Filter by stock exchange where companies are listed (e.g., NASDAQ, NYSE). Multiple values create an OR filter.

numEmployeesFrominteger

Integer. Filter for companies with at least this many employees.

numEmployeesTointeger

Integer. Filter for companies with no more than this many employees.

ipoFromstring date-time

Date. Filter for companies that went public on or after this date. Accepts ISO 8601 format (e.g., 2023-01-01T00:00:00) or yyyy-mm-dd format.

ipoTostring date-time

Date. Filter for companies that went public on or before this date. Accepts ISO 8601 format (e.g., 2023-12-31T23:59:59) or yyyy-mm-dd format.

qstring

String. Primary search query for filtering companies across name, alternative names, domains, and ticker symbols. Supports Boolean operators (AND, OR, NOT), exact phrases with quotes, and wildcards (* and ?) for flexible searching.

namestring

String. Search within company names. Supports Boolean operators (AND, OR, NOT), exact phrases with quotes, and wildcards (* and ?) for flexible searching.

industrystring

String. Filter by company industry classifications. Supports Boolean operators (AND, OR, NOT), exact phrases with quotes, and wildcards (* and ?) for flexible searching.

sectorstring

String. Filter by company sector classifications. Supports Boolean operators (AND, OR, NOT), exact phrases with quotes, and wildcards (* and ?) for flexible searching.

sizeinteger

Integer. The number of companies to return per page in the paginated response.

pageinteger

Integer. The specific page of results to retrieve in the paginated response. Starts at 0.

Response

200 - Success

statusinteger required
numResultsinteger required

Example response

{
  "status": 200,
  "numResults": 89660,
  "results": [
    {
      "id": "eeee660a046242b8bf99f45fdc95cc32",
      "name": "Tesla, Inc.",
      "updatedAt": "2025-08-02T06:28:15.799842+00:00",
      "altNames": [
        "Tesla"
      ],
      "domains": [
        "tesla.com"
      ],
      "monthlyVisits": 24914157,
      "globalRank": 1322,
      "description": "Tesla, Inc. designs, develops, manufactures, leases, and sells electric vehicles, and energy generation and storage systems in the United States, China, and internationally. It operates in two segments, Automotive, and Energy Generation and Storage. The Automotive segment offers electric vehicles, as well as sells automotive regulatory credits; and non-warranty after-sales vehicle, used vehicles, retail merchandise, and vehicle insurance services. This segment also provides sedans and sport utility vehicles through direct and used vehicle sales, a network of Tesla Superchargers, and in-app upgrades; purchase financing and leasing services; services for electric vehicles through its company-owned service locations and Tesla mobile service technicians; and vehicle limited warranties and extended service plans. The Energy Generation and Storage segment engages in the design, manufacture, installation, sale, and leasing of solar energy generation and energy storage products, and related services to residential, commercial, and industrial customers and utilities through its website, stores, and galleries, as well as through a network of channel partners; and provision of service and repairs to its energy product customers, including under warranty, as well as various financing options to its solar customers. The company was formerly known as Tesla Motors, Inc. and changed its name to Tesla, Inc. in February 2017. Tesla, Inc. was incorporated in 2003 and is headquartered in Austin, Texas.",
      "ceo": "Elon R. Musk",
      "industry": "Auto - Manufacturers",
      "sector": "Consumer Cyclical",
      "country": "us",
      "fullTimeEmployees": 125665,
      "address": "1 Tesla Road",
      "city": "Austin",
      "state": "TX",
      "zip": "78725",
      "logo": "https://company-api-assets.s3.us-east-2.amazonaws.com/images/TSLA.jpg",
      "favicon": "https://company-api-assets.s3.us-east-2.amazonaws.com/favicons/eeee660a046242b8bf99f45fdc95cc32.ico",
      "isEtf": false,
      "isActivelyTrading": true,
      "isFund": false,
      "isAdr": false,
      "symbols": [
        {
          "symbol": "TSLA",
          "exchange": "NASDAQ Global Select",
          "exchangeShortName": "NASDAQ",
          "ipoDate": "2010-06-29"
        },
        {
          "symbol": "TL0.DE",
          "exchange": "XETRA",
          "exchangeShortName": "XETRA",
          "ipoDate": "2010-06-29"
        }
      ],
      "naics": "8111",
      "sic": "7538",
      "yearFounded": 2003,
      "revenue": "over-1b",
      "webResources": {
        "careers": null,
        "about": null,
        "blog": null,
        "events": null,
        "sitemap": null,
        "updates": null,
        "linkedin": "https://www.linkedin.com/company/15564",
        "facebook": "https://www.facebook.com/tesla/",
        "instagram": null,
        "medium": null,
        "reddit": null,
        "threads": null,
        "tiktok": null,
        "x": "http://www.twitter.com/tesla",
        "wellfound": "http://angel.co/tesla-motors",
        "youtube": null,
        "wikipedia": null
      }
    }
  ]
}