Consultar CRF/FGTS

Consulta a situação de regularidade do empregador perante o FGTS na Caixa Econômica Federal, com validade e número do CRF.

GET /api/consultar-crf-fgts

Consulta a situação de regularidade do empregador perante o Fundo de Garantia do Tempo de Serviço (FGTS) na base da Caixa Econômica Federal. Estar regular no FGTS é condição para o empregador se relacionar com órgãos da administração pública e com instituições oficiais de crédito — por isso a certidão é exigida em licitações, contratos e operações de crédito rural.

Quando o empregador está regular, a resposta já traz a validade e o número do Certificado de Regularidade do FGTS (CRF).

A consulta é feita no portal oficial da Caixa e não exige certificado digital nem aceite do titular — basta o documento.

Autenticação

Envie sua chave no header X-API-Key. Veja Autenticação para detalhes.

Parâmetros de consulta

Você deve informar pelo menos um dos parâmetros cpf ou cnpj. Se ambos forem enviados, cnpj tem precedência.

Name	Type	Required	Description
`cpf`	string	Não	CPF do empregador pessoa física (somente números, 11 dígitos).
`cnpj`	string	Não	CNPJ do empregador (somente números, 14 dígitos).

Informe o CNPJ completo, com os 14 dígitos. O CNPJ básico (8 dígitos) faz o portal devolver a lista de estabelecimentos do grupo em vez da situação, e a consulta retorna status: "erro".

Exemplos de código

curl -X GET "https://api.fiscalapi.com.br/api/consultar-crf-fgts?cnpj=12345678000199" \
  -H "X-API-Key: fapi_sua_chave_aqui"

const response = await fetch(
  "https://api.fiscalapi.com.br/api/consultar-crf-fgts?cnpj=12345678000199",
  { headers: { "X-API-Key": "fapi_sua_chave_aqui" } }
);
const data = await response.json();
console.log(data.result.status, data.result.validade_iso);

import requests

response = requests.get(
    "https://api.fiscalapi.com.br/api/consultar-crf-fgts",
    headers={"X-API-Key": "fapi_sua_chave_aqui"},
    params={"cnpj": "12345678000199"},
)
data = response.json()
print(data["result"]["status"], data["result"]["validade_iso"])

$response = Http::withHeaders([
    'X-API-Key' => 'fapi_sua_chave_aqui',
])->get('https://api.fiscalapi.com.br/api/consultar-crf-fgts', [
    'cnpj' => '12345678000199',
]);
$data = $response->json();

var client = new HttpClient();
client.DefaultRequestHeaders.Add("X-API-Key", "fapi_sua_chave_aqui");
var response = await client.GetAsync(
    "https://api.fiscalapi.com.br/api/consultar-crf-fgts?cnpj=12345678000199"
);
var data = await response.Content.ReadAsStringAsync();

Resposta

Campos de nível superior

Campo	Tipo	Descrição
`request_id`	string	Identificador único da requisição (UUID).
`document`	string	Documento enviado na consulta.
`document_type`	string	Tipo do documento: `cpf` ou `cnpj`.
`cached`	boolean	Indica se o resultado veio do cache (TTL de 24h).
`source_status`	object	Status da fonte (`status`, `error_code`, `error_message`).
`result`	object	Dados da regularidade.

Campos de `result`

Campo	Tipo	Descrição
`tipo`	string	Sempre `crf_fgts` neste endpoint.
`status`	string	Status normalizado. Veja tabela abaixo.
`status_raw`	string	Texto original retornado pela Caixa.
`validade`	string	Último dia de validade do CRF (`DD/MM/AAAA`). Vazio quando não há certificado.
`validade_iso`	string	Mesma data em ISO 8601 (`YYYY-MM-DD`).
`emissao`	string	Data de emissão do CRF (`DD/MM/AAAA`).
`emissao_iso`	string	Data de emissão em ISO 8601 (`YYYY-MM-DD`).
`protocolo`	string	Número do Certificado de Regularidade do FGTS.
`pdf_base64`	string	Certificado em PDF (base64), quando o empregador está regular. Vem preenchido no `/api/consultar-crf-fgts`; nas consultas consolidadas (`/api/certidoes-todas`, `/api/perfil-produtor`) vem vazio, para não inflar a resposta.
`orgao`	string	Sempre `CEF` neste endpoint.

Valores de status do CRF/FGTS

Status	Significado
`negativa`	Empregador regular perante o FGTS. Traz validade e número do CRF.
`positiva`	Empregador não está regular perante o FGTS. Não há certificado a emitir.
`erro`	Não foi possível obter a situação. Veja `status_raw` e `source_status` para o motivo.

Exemplo de resposta

{
  "request_id": "uuid",
  "document": "12345678000199",
  "document_type": "cnpj",
  "cached": false,
  "source_status": {
    "status": "success",
    "error_code": "",
    "error_message": ""
  },
  "result": {
    "tipo": "crf_fgts",
    "status": "negativa",
    "status_raw": "REGULAR perante o FGTS",
    "validade": "22/08/2026",
    "validade_iso": "2026-08-22",
    "emissao": "24/07/2026",
    "emissao_iso": "2026-07-24",
    "protocolo": "2026072415210313570663",
    "orgao": "CEF"
  }
}

O pdf_base64 traz o Certificado de Regularidade do FGTS em PDF, montado a partir da página oficial de impressão da Caixa — o portal não disponibiliza o certificado como arquivo. O conteúdo é o da Caixa, com o número do certificado para conferência de autenticidade em www.caixa.gov.br.

Consumo de créditos

Cada consulta que retorna a situação consome 1 crédito. Respostas de erro — tanto os códigos abaixo quanto o status: "erro" em HTTP 200, quando o portal da Caixa não responde — não consomem crédito.

Códigos de erro

Código	HTTP Status	Descrição
`PARAMETRO_AUSENTE`	400	Nenhum documento (`cpf` ou `cnpj`) foi informado.
`LIMITE_ATINGIDO`	402	Cota mensal do plano esgotada (e sem créditos extras).
`RATE_LIMIT_EXCEEDED`	429	Rate limit do plano excedido.
`ERRO_INTERNO`	500	Erro interno no servidor.
`FEATURE_UNDER_REVIEW`	503	Funcionalidade temporariamente desativada para revisão.

Esta pagina foi util?

Consultar CRF/FGTS

On this page