---
title: "Get a list of Companies"
method: GET
path: "/v2/people/companies"
tags: ["People"]
---

# Get a list of Companies

`GET /v2/people/companies`

## Request

- Base URL: `https://your-subdomain.deputy.deputy.com/api`
- URL: `https://your-subdomain.deputy.deputy.com/api/v2/people/companies`
- Auth: API key in header `OAuth`

Get a list of Companies.

## Response `200`

A successful response.

- PeopleListCompaniesResponse
  - `companies` PeopleCompany[]
    - `Id` integer
    - `Portfolio` integer
    - `Code` string
    - `Active` boolean
    - `ParentCompany` integer
    - `CompanyName` string
    - `TradingName` string
    - `BusinessNumber` string
    - `CompanyNumber` string
    - `IsWorkplace` boolean
    - `IsPayrollEntity` boolean
    - `PayrollExportCode` string
    - `Address` integer
    - `Contact` integer
    - `Creator` integer
    - `Created` string
    - `Modified` string

---

[API](https://skmtc.dev/deputy/apis/deputy-v2-api.md) - [All operations](https://skmtc.dev/deputy/apis/deputy-v2-api/llms.txt) - [OpenAPI document](https://skmtc.dev/deputy/apis/deputy-v2-api/revisions/78f0278f4608?raw)