Caixa (FGTS)

Caixa Econômica Federal runs the FGTS, the severance fund every Brazilian employer pays into each month, and certifies which employers are up to date with it. Brazilian law requires the certificate (Certificado de Regularidade do FGTS, CRF) to borrow from public banks, to bid in public tenders and to receive public funds, which makes it a standard check in credit and supplier onboarding. Send a CNPJ and get the employer’s status: regular, with its current certificate, or irregular, with which body reports the impediment. Optionally the certificates it was issued over the last 24 months. POST /br/caixa/fgts-certificate/v1 Returns an employer’s FGTS status and its current certificate.

Field	Type	Notes
`document_number`	string	Required. Required. The company’s CNPJ, with or without punctuation, e.g. `33.000.167/0001-01`. Companies only: a CPF is rejected.
`include_history`	boolean	Optional. `true` to also get `history`, the certificates issued in the last 24 months. Default `false`.

curl https://api.croma.run/br/caixa/fgts-certificate/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "document_number": "33.000.167/0001-01" }'

Returns document_number, found, status (regular or irregular), status_label (the verdict as the source words it), impediments[], company_name, certificate, history (with include_history) and checked_at (ISO 8601, Brasília time). When regular, certificate is { number, valid_from, valid_until, address }: the certificate’s number, which anyone can check with Caixa, the day it was issued, the day it expires (30 days later), and the establishment’s address as { street, number, complement, district, city, state, postal_code, full }. When irregular, certificate is null and each impediments[] entry is { agency, message }: PGFN when FGTS debt is enrolled with the Union’s attorneys, CAIXA when the fund’s operator reports it. Each history[] entry is { issued_on, valid_from, valid_until, number }, newest first, covering the last 24 months. Entries from the early 2000s carry no number.

A company can be regular while in judicial recovery or bankruptcy: the certificate speaks only to the FGTS. Its status shows in company_name (e.g. EM RECUPERACAO JUDICIAL). A CNPJ that is not registered as an employer answers found: false.

The certificate is issued per company: a branch CNPJ returns the same number and validity as the head office, with its own address.

Full reference

Schemas, all response fields, and an interactive playground.

Get Started

Request types

Countries

Full reference