---
title: "Conta bancária do colaborador"
method: GET
path: "/{companyId}/banking/payroll/employees/{employeeTaxId}/account"
tags: ["Colaboradores"]
---

# Conta bancária do colaborador

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

Retorna o estado da conta bancária de um colaborador identificado pelo CPF.

**Parâmetro `bank`:**

| Valor | Comportamento |
|---|---|
| `BTG` (padrão) | Consulta a conta BTG do colaborador |
| `PAN` | Fallback para colaboradores sem conta BTG ativa |

Se a requisição sem `bank` retornar `404`, tente com `?bank=PAN`. Colaboradores no início do onboarding podem ainda não ter conta BTG ativa.

## Path parameters

- `companyId` string, required
- `employeeTaxId` string, required

## Query parameters

- `bank` string

## Response `200`

OK

- PayrollEmployeeAccountDetailResponseDto
  - `employeeId` string, nullable
  - `accountType` string, nullable
  - `status` string, nullable
  - `errors` string, nullable
  - `onboardingFinalizado` boolean
  - `onboardingFinishedAt` string, date-time, nullable
  - `bank` string, nullable
  - `agency` string, nullable
  - `number` string, nullable
  - `links` PayrollEmployeeAccountDetailLinksDto
    - `self` PayrollEmployeeLinkDto
      - `href` string, nullable
      - `method` string, nullable
      - `rel` string, nullable
    - `employee` 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)