---
title: "Get a list of company employees"
method: GET
path: "/company-employees"
tags: ["Company Employee"]
---

# Get a list of company employees

`GET /company-employees`

## Request

- Base URL: `https://api.gupy.io/api/v1`
- URL: `https://api.gupy.io/api/v1/company-employees`
- Auth: HTTP bearer

Get a list of company employees for internal recruitment

## Query parameters

- `id` integer
- `identificationDocument` string
- `name` string
- `perPage` integer
- `page` integer

## Response `200`

A confirmation of successful get of the company employees list

- PaginatedCompanyEmployee: Get response body
  - `results` CompanyEmployee[]
    - `id` integer: Id of the Company employee
    - `name` string: Company employee name
    - `countryOfOrigin` string: Company employee country abbreviation (eg. BR)
    - `identificationDocument` string: Company employee identification document
    - `companyId` integer: Id of the Company
  - `totalResults` integer
  - `page` integer
  - `totalPages` integer

## Other responses

- `400`: BadRequest / Invalid Input
- `401`: Unauthorized
- `403`: Forbidden

---

[API](https://skmtc.dev/gupy/apis/gupy-public-api.md) - [All operations](https://skmtc.dev/gupy/apis/gupy-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gupy/apis/gupy-public-api/revisions/b84c14658872?raw)