FGTS Authorization Consultation Manual

See also

• FGTS Origination

1. Beneficiary Authorization Consultation

The authorization consultation allows you to verify if the beneficiary has granted authorization for endorsement and balance inquiry in FGTS, linked to a specific CPF, to perform operations with Caixa Econômica Federal.

Consultation Characteristics

• Synchronous request: Returns result immediately
• Business rule: The consultation succeeds only for the last partner with whom the beneficiary has an active relationship
• Exception: If the beneficiary has not performed operations in the last 90 days, the consultation will return data for all partners

Requirements

To perform the consultation, the beneficiary's CPF is required.

Endpoint

GET

/fgts_issuer_auth_manager/issuer/{CPF}

Path Params

Field	Type	Description	Required	Format
document_number	string	Beneficiary's CPF number	Yes	11 numeric digits, no punctuation

Success Response

STATUS

200 (OK)

Response Examples

Authorized:

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

Not Authorized:

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

Error Response

STATUS

404 (Not Found)

Returned when the CPF is not found in the database.

Status Reference

Status	Description
authorized	Beneficiary has authorization
unauthorized	Beneficiary does not have authorization

Response Fields

Field	Type	Description
authorization_limit_date	string	Authorization expiration date (format: YYYY-MM-DD)
last_checked_at	string	Date of last authorization update
status	string	Current authorization status