Criar autorização de consulta de saldo FGTS

POST/v1/massa-dados/autorizacao-saldo-fgts

🔒 Requer Bearer token

Escopo emprestimos:write. **Disponível apenas em staging e homologação.** Popula a base de HOMOLOGAÇÃO da Dataprev com dados fictícios; em produção esta rota não existe (404). Registra a autorização do trabalhador para consulta do saldo FGTS — pré-requisito de GET /v1/fgts/saldo e GET /v1/fgts/autorizacoes.

Corpo da requisição

cpf_trabalhadorstringobrigatório

CPF do trabalhador que autoriza a consulta (11 dígitos).

padrão: ^\d{11}$

Respostas

Corpo da resposta 201

id_token_autorizacaointegerobrigatório

cpf_trabalhadorstringobrigatório

instituicao_financeiraobjectobrigatório

codigointegerobrigatório

descricaostringobrigatório

data_inclusaostring<date-time>obrigatório

data_validade_autorizacaostring<date>obrigatório

Request

curl -X POST 'https://econsignado-api.socinal.com.br/v1/massa-dados/autorizacao-saldo-fgts' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
  "cpf_trabalhador": "71931445028"
}'

Response

{
  "id_token_autorizacao": 999,
  "cpf_trabalhador": "71931445028",
  "instituicao_financeira": {
    "codigo": 1,
    "descricao": "CNPJ"
  },
  "data_inclusao": "2025-05-27T13:00:00.000Z",
  "data_validade_autorizacao": "2025-05-27"
}