---
title: "Listar colaboradores"
method: GET
path: "/{companyId}/banking/payroll/employees"
tags: ["Colaboradores"]
---

# Listar colaboradores

`GET /{companyId}/banking/payroll/employees`

Retorna lista paginada de colaboradores das empresas informadas com filtros opcionais. Paginação por cursor: use o valor de `_links.next.href` para navegar entre páginas.

**Status do colaborador:**

| Status | Significado |
|---|---|
| `active` | Colaborador ativo com conta BTG |
| `pending` | Onboarding em andamento, conta ainda não ativada |
| `suspended` | Conta suspensa |
| `inactive` | Colaborador desligado |

## Path parameters

- `companyId` string, required

## Query parameters

- `companyTaxIds` string[]
- `pageSize` integer
- `cursor` string
- `status` string
- `accountType` string
- `name` string
- `employeeTaxId` string
- `branch` string
- `accountNumber` string
- `portability` boolean
- `contractType` string

## Response `200`

OK

- PayrollEmployeeListResponseDto
  - `data` PayrollEmployeeListItemDto[], nullable
    - `name` string, nullable
    - `taxId` string, nullable
    - `personType` string, nullable
    - `status` string, nullable
    - `isActive` boolean
    - `onboardingCompleted` string, nullable
    - `isSuspended` boolean
    - `portability` boolean, nullable
    - `admissionDate` string, date-time, nullable
    - `terminationDate` string, date-time, nullable
    - `company` PayrollEmployeeListCompanyDto
      - `name` string, nullable
      - `taxId` string, nullable
    - `accounts` PayrollEmployeeListAccountDto[], nullable
      - `type` string, nullable
      - `status` string, nullable
      - `bankCode` string, nullable
      - `branch` string, nullable
      - `number` string, nullable
    - `links` PayrollEmployeeListItemLinksDto
      - `self` PayrollEmployeeLinkDto
        - `href` string, nullable
        - `method` string, nullable
        - `rel` string, nullable
  - `links` PayrollEmployeeListPaginationLinksDto
    - `next` PayrollEmployeeLinkDto
      - `href` string, nullable
      - `method` string, nullable
      - `rel` string, nullable
    - `previous` PayrollEmployeeLinkDto
      - `href` string, nullable
      - `method` string, nullable
      - `rel` string, nullable

---

[API](https://skmtc.net/btgpactual/apis/folha-de-pagamentos.md) · [All operations](https://skmtc.net/btgpactual/apis/folha-de-pagamentos/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/btgpactual/folha-de-pagamentos/revisions/2a24d3da114c/schema)