> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Caixa (FGTS)

> Brazil's FGTS regularity certificate (CRF) for any employer, by CNPJ: whether the company is up to date with the workers' severance fund, the certificate's number and validity, and what blocks it when it is not, from Caixa Econômica Federal.

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`.                                    |

```bash theme={"dark"}
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.

<Note>
  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`.
</Note>

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

<Card title="Full reference" icon="code" href="/api-reference/overview">
  Schemas, all response fields, and an interactive playground.
</Card>