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

# List entity companies

`GET /v1/companies`

## Request

- Base URL: `https://api.clients.wellhub.com`
- URL: `https://api.clients.wellhub.com/v1/companies`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/wellhub/apis/integrations-api/docs/v1/companies/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a paginated list of companies associated with the authenticated entity. Use the `cursor` parameter to paginate through results.

> **⚠️ Multi-entity clients only.** This endpoint is restricted to clients with a multi-entity credential. Single-entity clients will receive a `400: operation not available` error. If you are a single-entity client, use `GET /v1/employees` instead to retrieve your employees directly.

## Query parameters

- `cursor` string

## Response `200`

OK. Returns a paginated list of companies.

- CompaniesResponse
  - `data` Company[]: List of companies for the current page.
    - `company_name` string: The legal name of the company.
    - `company_tax_id` string: The tax identifier of the company (e.g. CNPJ in Brazil).
  - `cursor` string, nullable: Cursor for fetching the next page of results. `null` if there are no more results.

## Other responses

- `400`: Bad Request. Returned when a **single-entity client** calls this endpoint — it is restricted to multi-entity clients only. The error body will contain `operation not available`.
- `401`: Unauthorized. Missing or invalid Bearer token.
- `403`: Forbidden. The authenticated entity does not have access to this resource.
- `500`: Internal Server Error.

---

[API](https://skmtc.dev/wellhub/apis/integrations-api.md) - [All operations](https://skmtc.dev/wellhub/apis/integrations-api/llms.txt) - [OpenAPI document](https://skmtc.dev/wellhub/apis/integrations-api/revisions/3e6a46a18a2e?raw)