Manual de Consulta de Autorização FGTS

1. Consulta de Autorização do Beneficiário

A consulta de autorização permite verificar se o beneficiário concedeu autorização para averbação e consulta de saldo no FGTS, vinculada a um CPF específico, para realizar operações junto à Caixa Econômica Federal.

Características da Consulta

• Requisição síncrona: Retorna resultado imediatamente
• Regra de negócio: O sucesso da consulta ocorre apenas para o último parceiro com quem o beneficiário possui vínculo ativo
• Exceção: Caso o beneficiário não tenha realizado operações nos últimos 90 dias, a consulta retornará com dados para todos os parceiros

Requisitos

Para realizar a consulta, é necessário o CPF do beneficiário.

Endpoint

GET

/fgts_issuer_auth_manager/issuer/{CPF}

Path Params

Campo	Tipo	Descrição	Obrigatório	Formatação
document_number	string	Número do CPF do beneficiário	Sim	11 dígitos numéricos, sem pontuação

Resposta de Sucesso

STATUS

200 (OK)

Exemplos de Resposta

Autorizado:

{
    "authorization_limit_date": "2026-01-01",
    "last_checked_at": "2025-10-01",
    "status": "authorized"
}

Não Autorizado:

{
    "authorization_limit_date": null,
    "last_checked_at": "2025-10-01",
    "status": "unauthorized"
}

Resposta de Erro

STATUS

404 (Not Found)

Retornado quando o CPF não foi encontrado na base.

Referência de Status

Status	Descrição
authorized	Beneficiário possui autorização
unauthorized	Beneficiário não possui autorização

Campos de Resposta

Campo	Tipo	Descrição
authorization_limit_date	string	Data limite da autorização (formato: YYYY-MM-DD)
last_checked_at	string	Data da última atualização da autorização
status	string	Status atual da autorização