> ## 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)

> O Certificado de Regularidade do FGTS (CRF) de qualquer empregador, por CNPJ: se a empresa está em dia com o FGTS, o número e a validade do certificado, e o que o impede quando não está, da Caixa Econômica Federal.

A Caixa Econômica Federal é o agente operador do FGTS, o fundo que todo
empregador recolhe mensalmente, e certifica quais empregadores estão em dia
com ele. A lei exige o Certificado de Regularidade do FGTS (CRF) para obter
crédito em bancos públicos, participar de licitações e receber recursos
públicos, o que o torna uma verificação padrão no cadastro de clientes de
crédito e de fornecedores.

Envie um CNPJ e receba a situação do empregador: regular, com o certificado
vigente, ou irregular, com o órgão que informa o impedimento. Opcionalmente,
os certificados emitidos nos últimos 24 meses.

`POST /br/caixa/fgts-certificate/v1` Retorna a situação de um empregador perante o FGTS e o certificado vigente.

| Campo             | Tipo    | Notas                                                                                                                                   |
| ----------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| `document_number` | string  | **Obrigatório.** **Obrigatório.** O CNPJ da empresa, com ou sem pontuação, p. ex. `33.000.167/0001-01`. Só empresas: um CPF é recusado. |
| `include_history` | boolean | Opcional. `true` para receber também `history`, os certificados emitidos nos últimos 24 meses. Por padrão `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" }'
```

Retorna `document_number`, `found`, `status` (`regular` ou `irregular`), `status_label` (o veredito como a fonte o redige), `impediments[]`, `company_name`, `certificate`, `history` (com `include_history`) e `checked_at` (ISO 8601, horário de Brasília).

Quando `regular`, `certificate` é `{ number, valid_from, valid_until, address }`: o número do certificado, que qualquer um pode conferir na Caixa, o dia em que foi emitido, o dia em que vence (30 dias depois) e o endereço do estabelecimento como `{ street, number, complement, district, city, state, postal_code, full }`. Quando `irregular`, `certificate` é null e cada elemento de `impediments[]` é `{ agency, message }`: `PGFN` quando há débito de FGTS inscrito na Procuradoria-Geral da Fazenda Nacional, `CAIXA` quando o agente operador o informa.

Cada elemento de `history[]` é `{ issued_on, valid_from, valid_until, number }`, do mais recente ao mais antigo, cobrindo os últimos 24 meses. Registros do início dos anos 2000 vêm sem número.

<Note>
  Uma empresa pode estar `regular` em recuperação judicial ou falência: o
  certificado fala só do FGTS. A situação aparece em `company_name` (p. ex.
  `EM RECUPERACAO JUDICIAL`). Um CNPJ que não está cadastrado como empregador
  retorna `found: false`.
</Note>

<Note>
  O certificado é emitido por empresa: o CNPJ de uma filial retorna o mesmo
  número e validade da matriz, com o próprio endereço.
</Note>

<Card title="Referência completa" icon="code" href="/pt/api-reference/overview">
  Esquemas, todos os campos de resposta e um playground interativo.
</Card>