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
      }
    }
  ]
}

Changes

Changed in 6 of the 17 revisions of this API.33987

Oct 10, 20253c4040a8dce33See the full diff
- ○
  added the optional property results/items/cik to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property results/items/cusip to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property results/items/isin to the response with the 200 status
  response-optional-property-added
Aug 18, 2025a73a3b58ca6612278See the full diff
- ▲
  the status response's property type/format changed from string/ to integer/int32 for status 429
  response-property-type-changed
- ●
  removed the optional property cause from the response with the 400 status
  response-optional-property-removed
- ●
  removed the optional property cause from the response with the 401 status
  response-optional-property-removed
- ●
  removed the optional property cause from the response with the 403 status
  response-optional-property-removed
- ●
  removed the optional property cause from the response with the 429 status
  response-optional-property-removed
- ●
  removed the optional property cause from the response with the 500 status
  response-optional-property-removed
- ●
  removed the optional property localizedMessage from the response with the 400 status
  response-optional-property-removed
- ●
  removed the optional property localizedMessage from the response with the 401 status
  response-optional-property-removed
- ●
  removed the optional property localizedMessage from the response with the 403 status
  response-optional-property-removed
- ●
  removed the optional property localizedMessage from the response with the 429 status
  response-optional-property-removed
- ●
  removed the optional property localizedMessage from the response with the 500 status
  response-optional-property-removed
- ●
  removed the optional property stackTrace from the response with the 400 status
  response-optional-property-removed
- ●
  removed the optional property stackTrace from the response with the 401 status
  response-optional-property-removed
- ●
  removed the optional property stackTrace from the response with the 403 status
  response-optional-property-removed
- ●
  removed the optional property stackTrace from the response with the 429 status
  response-optional-property-removed
- ●
  removed the optional property stackTrace from the response with the 500 status
  response-optional-property-removed
- ●
  removed the optional property statusCode from the response with the 401 status
  response-optional-property-removed
- ●
  removed the optional property statusCode from the response with the 403 status
  response-optional-property-removed
- ●
  removed the optional property suppressed from the response with the 400 status
  response-optional-property-removed
- ●
  removed the optional property suppressed from the response with the 401 status
  response-optional-property-removed
- ●
  removed the optional property suppressed from the response with the 403 status
  response-optional-property-removed
- ●
  removed the optional property suppressed from the response with the 429 status
  response-optional-property-removed
- ●
  removed the optional property suppressed from the response with the 500 status
  response-optional-property-removed
- ○
  the endpoint scheme security apiKeyAuth was added to the API
  api-security-added
- ○
  added the optional property status to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property status to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property status to the response with the 403 status
  response-optional-property-added
- ○
  added the optional property status to the response with the 500 status
  response-optional-property-added
- ○
  added the optional property timestamp to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property timestamp to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property timestamp to the response with the 403 status
  response-optional-property-added
- ○
  added the optional property timestamp to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property timestamp to the response with the 500 status
  response-optional-property-added
- ○
  removed the 100 CONTINUE enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 101 SWITCHING_PROTOCOLS enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 102 PROCESSING enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 103 CHECKPOINT enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 200 OK enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 201 CREATED enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 202 ACCEPTED enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 203 NON_AUTHORITATIVE_INFORMATION enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 204 NO_CONTENT enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 205 RESET_CONTENT enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 206 PARTIAL_CONTENT enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 207 MULTI_STATUS enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 208 ALREADY_REPORTED enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 226 IM_USED enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 300 MULTIPLE_CHOICES enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 301 MOVED_PERMANENTLY enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 302 FOUND enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 302 MOVED_TEMPORARILY enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 303 SEE_OTHER enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 304 NOT_MODIFIED enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 305 USE_PROXY enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 307 TEMPORARY_REDIRECT enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 308 PERMANENT_REDIRECT enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 400 BAD_REQUEST enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 401 UNAUTHORIZED enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 402 PAYMENT_REQUIRED enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 403 FORBIDDEN enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 404 NOT_FOUND enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 405 METHOD_NOT_ALLOWED enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 406 NOT_ACCEPTABLE enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 407 PROXY_AUTHENTICATION_REQUIRED enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 408 REQUEST_TIMEOUT enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 409 CONFLICT enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 410 GONE enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 411 LENGTH_REQUIRED enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 412 PRECONDITION_FAILED enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 413 PAYLOAD_TOO_LARGE enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 413 REQUEST_ENTITY_TOO_LARGE enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 414 REQUEST_URI_TOO_LONG enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 414 URI_TOO_LONG enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 415 UNSUPPORTED_MEDIA_TYPE enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 416 REQUESTED_RANGE_NOT_SATISFIABLE enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 417 EXPECTATION_FAILED enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 418 I_AM_A_TEAPOT enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 419 INSUFFICIENT_SPACE_ON_RESOURCE enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 420 METHOD_FAILURE enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 421 DESTINATION_LOCKED enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 422 UNPROCESSABLE_ENTITY enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 423 LOCKED enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 424 FAILED_DEPENDENCY enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 425 TOO_EARLY enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 426 UPGRADE_REQUIRED enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 428 PRECONDITION_REQUIRED enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 429 TOO_MANY_REQUESTS enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 431 REQUEST_HEADER_FIELDS_TOO_LARGE enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 451 UNAVAILABLE_FOR_LEGAL_REASONS enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 500 INTERNAL_SERVER_ERROR enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 501 NOT_IMPLEMENTED enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 502 BAD_GATEWAY enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 503 SERVICE_UNAVAILABLE enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 504 GATEWAY_TIMEOUT enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 505 HTTP_VERSION_NOT_SUPPORTED enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 506 VARIANT_ALSO_NEGOTIATES enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 507 INSUFFICIENT_STORAGE enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 508 LOOP_DETECTED enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 509 BANDWIDTH_LIMIT_EXCEEDED enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 510 NOT_EXTENDED enum value from the status response property for the response status 429
  response-property-enum-value-removed
- ○
  removed the 511 NETWORK_AUTHENTICATION_REQUIRED enum value from the status response property for the response status 429
  response-property-enum-value-removed
This revision also has 5 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Aug 4, 20253eb8ae4622b82171See the full diff
- ▲
  the response property results/items/webResources became nullable for the status 200
  response-property-became-nullable
- ▲
  the results/items/webResources response's property type/format changed from object/ to / for status 200
  response-property-type-changed
- ●
  removed the optional property results/items/webResources/about from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property results/items/webResources/blog from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property results/items/webResources/careers from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property results/items/webResources/events from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property results/items/webResources/facebook from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property results/items/webResources/instagram from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property results/items/webResources/linkedin from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property results/items/webResources/medium from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property results/items/webResources/reddit from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property results/items/webResources/sitemap from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property results/items/webResources/threads from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property results/items/webResources/tiktok from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property results/items/webResources/updates from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property results/items/webResources/wellfound from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property results/items/webResources/wikipedia from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property results/items/webResources/x from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property results/items/webResources/youtube from the response with the 200 status
  response-optional-property-removed
- ○
  added WebResources to the results/items/webResources response property allOf list for the response status 200
  response-property-all-of-added
Jul 31, 2025556127fafa6a1See the full diff
- ○
  api tag Supplemental Endpoints removed
  api-tag-removed
Jun 4, 202552b02cb255321See the full diff
- ○
  api tag Supplemental Endpoints added
  api-tag-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
May 8, 2025ae72ecd67fb13See the full diff
- ○
  the response property numResults became required for the status 200
  response-property-became-required
- ○
  the response property results became required for the status 200
  response-property-became-required
- ○
  the response property status became required for the status 200
  response-property-became-required

Full history