---
title: "Companies"
method: GET
path: "/v1/companies/all"
tags: ["v1"]
---

# Companies

`GET /v1/companies/all`

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.

## Query parameters

- `id` string[]
- `symbol` string[]
- `domain` string[]
- `country` string[]
- `exchange` string[]
- `numEmployeesFrom` integer
- `numEmployeesTo` integer
- `ipoFrom` string, date-time
- `ipoTo` string, date-time
- `q` string
- `name` string
- `industry` string
- `sector` string
- `size` integer
- `page` integer

## Response `200`

200 - Success

- CompanySearchResult — Company search result
  - `status` integer, required
  - `numResults` integer, required
  - `results` Company[], required
    - `id` string, nullable
    - `name` string, nullable
    - `updatedAt` string, nullable
    - `primaryRecordId` string, nullable
    - `altNames` string[], nullable
    - `domains` string[], nullable
    - `monthlyVisits` integer, nullable
    - `globalRank` integer, nullable
    - `description` string, nullable
    - `ceo` string, nullable
    - `industry` string, nullable
    - `sector` string, nullable
    - `country` string, nullable
    - `fullTimeEmployees` integer, nullable
    - `address` string, nullable
    - `city` string, nullable
    - `state` string, nullable
    - `zip` string, nullable
    - `logo` string, nullable
    - `favicon` string, nullable
    - `isEtf` boolean, nullable
    - `isActivelyTrading` boolean, nullable
    - `isFund` boolean, nullable
    - `isAdr` boolean, nullable
    - `symbols` SymbolHolder[], nullable
      - `symbol` string, nullable
      - `exchange` string, nullable
      - `exchangeShortName` string, nullable
      - `ipoDate` string, nullable
    - `naics` string, nullable
    - `sic` string, nullable
    - `cusip` string, nullable
    - `cik` string, nullable
    - `isin` string, nullable
    - `yearFounded` integer, nullable
    - `revenue` string, nullable
    - `webResources` WebResources
      - `careers` string, nullable
      - `about` string, nullable
      - `blog` string, nullable
      - `events` string, nullable
      - `sitemap` string, nullable
      - `updates` string, nullable
      - `linkedin` string, nullable
      - `facebook` string, nullable
      - `instagram` string, nullable
      - `medium` string, nullable
      - `reddit` string, nullable
      - `threads` string, nullable
      - `tiktok` string, nullable
      - `x` string, nullable
      - `wellfound` string, nullable
      - `youtube` string, nullable
      - `wikipedia` string, nullable

## Other responses

- `400` — 400 - Bad Request
- `401` — 401 - Invalid API Key
- `403` — 403 - Request Forbidden
- `429` — 429 - Too Many Requests
- `500` — 500 - Server Error

## Changes

- **2025-10-10** `3c4040a8dce3` — 3 info
  - added the optional property `results/items/cik` to the response with the `200` status
  - added the optional property `results/items/cusip` to the response with the `200` status
  - added the optional property `results/items/isin` to the response with the `200` status
- **2025-08-18** `a73a3b58ca66` — 1 breaking, 22 warning, 78 info
  - the `status` response's property type/format changed from `string`/`` to `integer`/`int32` for status `429`
  - removed the optional property `cause` from the response with the `400` status
  - removed the optional property `cause` from the response with the `401` status
  - removed the optional property `cause` from the response with the `403` status
  - …97 more
- **2025-08-04** `3eb8ae4622b8` — 2 breaking, 17 warning, 1 info
  - the response property `results/items/webResources` became nullable for the status `200`
  - the `results/items/webResources` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - removed the optional property `results/items/webResources/about` from the response with the `200` status
  - removed the optional property `results/items/webResources/blog` from the response with the `200` status
  - …16 more
- **2025-07-31** `556127fafa6a` — 1 info
  - api tag `Supplemental Endpoints` removed
- **2025-06-04** `52b02cb25532` — 1 info
  - api tag `Supplemental Endpoints` added

[Full history](https://skmtc.dev/goperigon/apis/perigon-api/changes/v1/companies/all/get.md)

---

[API](https://skmtc.dev/goperigon/apis/perigon-api.md) · [All operations](https://skmtc.dev/goperigon/apis/perigon-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/goperigon/perigon-api/revisions/2c55bf07003a/schema)