---
title: "Caixa FGTS Regularity Certificate (CRF)"
method: POST
path: "/br/caixa/fgts-certificate/v1"
tags: ["Brazil", "Caixa Econômica Federal (FGTS)"]
---

# Caixa FGTS Regularity Certificate (CRF)

`POST /br/caixa/fgts-certificate/v1`

## Request

- Base URL: `https://api.croma.run`
- URL: `https://api.croma.run/br/caixa/fgts-certificate/v1`
- Auth: HTTP bearer

Check whether a Brazilian employer is up to date with the FGTS, by CNPJ, from Caixa Econômica Federal: `regular` with the current Certificado de Regularidade do FGTS (number, validity, establishment address), or `irregular` with which body reports the impediment (PGFN or Caixa). Optionally the certificates issued in the last 24 months. `found: false` when the CNPJ is not registered as an employer.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `document_number` string, required: CNPJ de la empresa, con o sin puntuación, p. ej. `33.000.167/0001-01`. Solo empresas: un CPF no se acepta.
  - `include_history` boolean: Si es `true`, la respuesta incluye `history`, los certificados emitidos en los últimos 24 meses (opcional).

## Response `200`

Successful response

- CaixaFgtsCertificateResponse
  - `data` CaixaFgtsCertificateData, required
    - `document_number` string, required: The CNPJ queried, 14 characters, echoed back.
    - `found` boolean, required: false when the CNPJ is not registered as an employer with the FGTS.
    - `status` 'regular' | 'irregular', nullable, required: `regular` (a valid certificate exists) or `irregular` (impediments block it); null when not found.
    - `status_label` string, nullable, required: The source's verdict sentence(s), verbatim.
    - `impediments` object[], required: What blocks the certificate; empty unless `irregular`.
      - `agency` 'PGFN' | 'CAIXA', required: Who reports it: `PGFN` (FGTS debt enrolled with the Union's attorneys) or `CAIXA` (the fund's operator).
      - `message` string, required: What the source says, verbatim.
    - `company_name` string, nullable, required: The company's name (razão social) as the source prints it, including suffixes like `EM RECUPERACAO JUDICIAL`.
    - `certificate` object, nullable, required: The current certificate; null unless `regular`.
      - `number` string, required: The certificate's number (22 digits), which anyone can check with the source.
      - `valid_from` string, required: `yyyy-mm-dd` the certificate was issued and starts being valid.
      - `valid_until` string, required: `yyyy-mm-dd` it stops being valid: 30 days after issue.
      - `address` object, required: The establishment's address as the certificate prints it.
        - `street` string, nullable, required: Street type and name, e.g. `AV REPUBLICA DO CHILE`.
        - `number` string, nullable, required: The street number, as printed.
        - `complement` string, nullable, required: Floor, suite or block; null when there is none.
        - `district` string, nullable, required: The neighbourhood (bairro).
        - `city` string, nullable, required
        - `state` string, nullable, required: Two-letter state (UF), e.g. `RJ`.
        - `postal_code` string, nullable, required: CEP, `NNNNN-NNN`.
        - `full` string, required: The whole address on one line, as printed.
    - `history` object[], nullable, required: Certificates issued in the last 24 months, newest first, when `include_history` was true; null otherwise.
      - `issued_on` string, required: `yyyy-mm-dd` the certificate was issued.
      - `valid_from` string, required: `yyyy-mm-dd`.
      - `valid_until` string, required: `yyyy-mm-dd`.
      - `number` string, nullable, required: The certificate's number; null on early-2000s entries, which carry none.
    - `checked_at` string, required: When the source answered, ISO 8601 in Brasília time.

## Other responses

- `400`: Invalid request body
- `401`: Missing or invalid API key
- `429`: Rate limit exceeded
- `500`: Internal error
- `502`: Upstream source returned an error

---

[API](https://skmtc.dev/usecroma/apis/croma-marketplace-api.md) · [All operations](https://skmtc.dev/usecroma/apis/croma-marketplace-api/llms.txt) · [OpenAPI document](https://skmtc.dev/usecroma/apis/croma-marketplace-api/revisions/df016cdb29d7?raw)