---
title: "GET /api/v1/employees"
method: GET
path: "/api/v1/employees"
tags: ["Public API"]
---

# GET /api/v1/employees

`GET /api/v1/employees`

Lista todos os colaboradores da empresa

## Response `200`

- object
  - `employees` object[], required
    - `id` string, required — Identificador do colaborador na plataforma Salvy (UUID)
    - `fullName` string, required — Nome completo
    - `socialName` string, nullable, required — Nome social
    - `status` 'active' | 'terminated' | 'on-hold', required — Situação do colaborador
    - `workEmail` string, nullable, required — A valid email address.
    - `personalEmail` string, nullable, required — A valid email address.
    - `workPhoneNumber` string, nullable, required — Phone number in E.164 format. Supports Brazilian numbers (+55).
    - `personalPhoneNumber` string, nullable, required — Phone number in E.164 format. Supports Brazilian numbers (+55).
    - `cpf` string, nullable, required — A valid CPF number.
    - `cnpj` string, nullable, required — A valid CNPJ number (numeric or alphanumeric).
    - `rg` string, nullable, required — RG do colaborador
    - `position` string, nullable, required — Cargo do colaborador
    - `area` string, nullable, required — Área do colaborador
    - `managerFullName` string, nullable, required — Nome do gestor
    - `birthDate` string, nullable, required — A date in ISO 8601 format.
    - `contractType` 'pj' | 'clt' | 'intern' | 'apprentice' | 'temporary' | 'third-party', nullable, required — Tipo de contrato
    - `contractEndDate` string, nullable, required — A date in ISO 8601 format.
    - `admittedAt` string, nullable, required — A date in ISO 8601 format.
    - `terminatedAt` string, nullable, required — A date in ISO 8601 format.
    - `address` object, nullable, required — Endereço do colaborador
      - `zipCode` string, nullable, required — CEP
      - `streetName` string, nullable, required — Nome da rua
      - `streetNumber` string, nullable, required — Número da casa
      - `complement` string, nullable, required — Complemento do endereço
      - `neighborhood` string, nullable, required — Bairro
      - `city` string, nullable, required — Cidade
      - `state` string, nullable, required — Estado
      - `country` string, nullable, required — País
    - `customFields` object[], required — Campos personalizados do colaborador
      - `label` string, required
      - `type` 'text' | 'select', required
      - `value` string, required
    - `bankAccount` object, nullable, required — Dados bancários do colaborador
      - `bank` string, nullable, required — Banco
      - `branch` string, nullable, required — Agência
      - `accountNumber` string, nullable, required — Número da conta
      - `accountType` 'checking' | 'savings' | 'salary' | 'payment', nullable, required — Tipo de conta
      - `pixKey` string, nullable, required — Chave PIX
    - `salaryCents` number, nullable, required — Salário em centavos
    - `sources` union[], required — Fontes de integração do colaborador
      - union
        - object
          - `id` 'manual', required
          - `platform` 'manual', required
        - object
          - `id` string, required
          - `platform` 'sheets', required
        - object
          - `id` string, required
          - `platform` string, required
    - `createdAt` string, date-time, required — Data de criação do colaborador
    - `assetCount` number, required — Quantidade de ativos vinculados ao colaborador
    - `phoneAccountCount` number, required — Quantidade de linhas Salvy vinculadas ao colaborador
    - `externalPhoneAccountCount` number, required — Quantidade de linhas de outras operadoras vinculadas ao colaborador

## Other responses

- `401`
- `403`
- `404`
- `413`
- `422`
- `500`

---

[API](https://skmtc.net/salvy/apis/salvy-api.md) · [All operations](https://skmtc.net/salvy/apis/salvy-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/salvy/salvy-api/versions/35784581fe38/schema)