> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zipdin.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Consulta de saldo FGTS

> Consulta o saldo/multa do FGTS do trabalhador para uso como garantia na operação

<Note>Etapa **opcional** — necessária apenas quando o trabalhador vai usar o FGTS como garantia.</Note>

Consulta o saldo ou a multa do FGTS do trabalhador na DATAPREV, necessária quando esses valores serão
usados como garantia na operação.

<Info>
  Todos os endpoints requerem autenticação via **Bearer token** no header `Authorization`.
  Consulte o [guia de autenticação](/docs/primeiros-passos/authentication) para obter suas credenciais e gerar um token.
</Info>

<Note>
  O endpoint real se chama `worker-fgts` — confirmado no código-fonte do Dataprev Controller (o PDF de
  negócio o chamava de `fgts-balance-inquiries`). Usa o mesmo schema da
  [Consulta de dados do trabalhador](/docs/e-consignado/dados-trabalhador#parâmetros).
</Note>

## Parâmetros

<ParamField body="cpf" type="string" required>
  CPF do trabalhador — 8 a 11 dígitos numéricos
</ParamField>

<ParamField body="employerRegistrationNumber" type="string" required>
  Número de inscrição do empregador (1 a 14 caracteres)
</ParamField>

<ParamField body="workerRegistrationNumber" type="string" required>
  Matrícula do trabalhador (1 a 30 caracteres)
</ParamField>

<ParamField body="employerRegistrationType" type="string" required>
  Tipo de inscrição do empregador (1 a 14 caracteres)
</ParamField>

## Exemplo

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST https://hml.zipdin.com.br/dataprev-controller/worker-fgts \
    -H "x-api-key: SUA_API_KEY" \
    -H "Authorization: Bearer SEU_TOKEN" \
    -H "x-idempotency-key: 3f8a91b2-7c4d-4e5f-a6b7-8c9d0e1f2a3b" \
    -H "Content-Type: application/json" \
    -d '{
      "cpf": "52998224725",
      "employerRegistrationNumber": "42422253",
      "workerRegistrationNumber": "ZIPGERAL",
      "employerRegistrationType": "1"
    }'
  ```
</CodeGroup>

<ResponseExample>
  ```json 202 - Enfileirado theme={null}
  {
    "requestId": "e7f8a9b0-c1d2-3456-e7f8-a9b0c1d23456",
    "status": "queued"
  }
  ```
</ResponseExample>
