Consultar saldo FGTS

GET/v1/fgts/saldo

🔒 Requer Bearer token

Escopo fgts:read. Retorna o saldo disponível e a multa rescisória do trabalhador no empregador. Pré-condição: autorização de saldo FGTS ativo: true em GET /v1/fgts/autorizacoes **e** autorização de margem vigente do CPF (POST /v1/margem/autorizacao) — o token de consulta Dataprev é resolvido pelo servidor a partir dela (tokenAutorizacao é opcional). Sem autorização vigente: 401 AUTORIZACAO_PENDENTE. Sem registro retorna { "saldo": null }.

Parâmetros

cpfstringqueryobrigatório

CPF do trabalhador (11 dígitos, sem máscara)

padrão: ^\d{11}$

token_autorizacaostringqueryopcional

Token de autorização de consulta Dataprev. **Opcional** — quando omitido, o servidor usa o token da autorização de margem vigente do CPF (de `POST /v1/margem/autorizacao`). Informe apenas se você já possui um token próprio.

matriculastringqueryobrigatório

Matrícula do trabalhador no empregador

codigo_inscricao_empregadornumberqueryobrigatório

Tipo de inscrição do empregador. `1` = CNPJ, `2` = CPF.

numero_inscricao_empregadorstringqueryobrigatório

Número da inscrição do empregador, exatamente como veio em `GET /v1/margem/vinculos`. É **string**: o CNPJ pode ser alfanumérico (IN RFB 2.229/2024, ex.: `R7ZW4H8H000140`) e zeros à esquerda são significativos. Máscara (`.`, `/`, `-`) é aceita e removida.

máx. 30 car. · padrão: ^[A-Z0-9]{1,30}$

Respostas

Corpo da resposta 200

saldoobjectobrigatórionullable

data_hora_consultastring<date-time>obrigatório

valor_saldo_disponivel_consignadonumberobrigatório

valor_multa_rescisoria_consignadonumberobrigatório

Request

curl -X GET 'https://econsignado-api.socinal.com.br/v1/fgts/saldo?cpf=valor&token_autorizacao=valor&matricula=valor&codigo_inscricao_empregador=valor&numero_inscricao_empregador=valor' \
  -H 'Authorization: Bearer SEU_TOKEN'

Response

{
  "saldo": {
    "data_hora_consulta": "2025-07-03T17:15:00.000Z",
    "valor_saldo_disponivel_consignado": 2000,
    "valor_multa_rescisoria_consignado": 1000
  }
}