Consultar Todas as Certidões

Consulta em uma chamada a CND Estadual nos 27 estados, a CNDT, a CND Federal e o CRF/FGTS de um contribuinte.

GET /api/certidoes-todas

Consulta, em uma única chamada e em paralelo, as certidões de regularidade de um contribuinte:

CND Estadual (ICMS) nos 27 estados — a mesma consulta do Consultar CND em Todos os Estados;
CNDT (débitos trabalhistas, TST) — a mesma do Consultar CNDT;
CND Federal (tributos federais e Dívida Ativa da União, RFB+PGFN) — a mesma do Consultar CND Federal;
CRF/FGTS (Caixa) — a mesma do Consultar CRF/FGTS.

Cada certidão traz o próprio source_status. Se uma delas falhar, as outras continuam e a resposta volta com o que foi obtido.

Esta consulta pode levar mais de um minuto e é encerrada em 90 segundos. Configure na sua aplicação um timeout de pelo menos 120 segundos.

A resposta consolidada não traz os PDFs (pdf_base64 vem vazio em todas as certidões), para não inflar o retorno. Para baixar o PDF de uma certidão, consulte o endpoint individual dela.

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 contribuinte (somente números, 11 dígitos).
`cnpj`	string	Não	CNPJ do contribuinte (somente números, 14 dígitos).
`skip_estaduais`	boolean	Não	`true` pula a CND Estadual e consulta só as certidões federais (resposta mais rápida). Padrão: `false`.

A CND Federal, por enquanto, é emitida somente para CNPJ. Em consultas por cpf, o item cnd_federal volta com status: "erro"; as demais certidões são consultadas normalmente.

Exemplos de código

curl -X GET "https://api.fiscalapi.com.br/api/certidoes-todas?cnpj=12345678000199" \
  -H "X-API-Key: fapi_sua_chave_aqui" \
  --max-time 120

const response = await fetch(
  "https://api.fiscalapi.com.br/api/certidoes-todas?cnpj=12345678000199",
  {
    headers: { "X-API-Key": "fapi_sua_chave_aqui" },
    signal: AbortSignal.timeout(120_000),
  }
);
const data = await response.json();

for (const certidao of data.certidoes_federais) {
  console.log(certidao.result?.tipo, certidao.result?.status ?? certidao.source_status.error_code);
}
for (const estado of data.cnd_estaduais?.results ?? []) {
  console.log(estado.uf, estado.result?.status ?? estado.source_status.status);
}

import requests

response = requests.get(
    "https://api.fiscalapi.com.br/api/certidoes-todas",
    headers={"X-API-Key": "fapi_sua_chave_aqui"},
    params={"cnpj": "12345678000199"},
    timeout=120,
)
data = response.json()

for certidao in data["certidoes_federais"]:
    if certidao["result"]:
        print(certidao["result"]["tipo"], certidao["result"]["status"])
    else:
        print(certidao["source_status"]["error_code"])

for estado in (data["cnd_estaduais"] or {}).get("results", []):
    status = estado["result"]["status"] if estado["result"] else estado["source_status"]["status"]
    print(f"{estado['uf']}: {status}")

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

var client = new HttpClient { Timeout = TimeSpan.FromSeconds(120) };
client.DefaultRequestHeaders.Add("X-API-Key", "fapi_sua_chave_aqui");
var response = await client.GetAsync(
    "https://api.fiscalapi.com.br/api/certidoes-todas?cnpj=12345678000199"
);
var data = await response.Content.ReadAsStringAsync();

Somente as certidões federais

curl -X GET "https://api.fiscalapi.com.br/api/certidoes-todas?cnpj=12345678000199&skip_estaduais=true" \
  -H "X-API-Key: fapi_sua_chave_aqui"

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`.
`cnd_estaduais`	object \| null	CND Estadual nos 27 estados. `null` quando `skip_estaduais=true` ou quando a consulta estadual não pôde ser concluída.
`certidoes_federais`	array	Sempre três itens, nesta ordem: CNDT, CND Federal e CRF/FGTS.

Campos de `cnd_estaduais`

Mesma estrutura da resposta do Consultar CND em Todos os Estados:

Campo	Tipo	Descrição
`request_id`	string	Identificador da requisição.
`document`	string	Documento consultado.
`document_type`	string	`cpf` ou `cnpj`.
`results`	array	Um item por UF, com `uf`, `source_status` e `result` (dados da certidão ou `null`). Os campos de `result` estão em Consultar CND por UF.

Campos de cada item de `certidoes_federais[]`

Mesma estrutura da resposta dos endpoints individuais:

Campo	Tipo	Descrição
`request_id`	string	Identificador da requisição.
`document`	string	Documento consultado.
`document_type`	string	`cpf` ou `cnpj`.
`cached`	boolean	Indica se o resultado veio do cache.
`source_status`	object	Status da consulta desta certidão (`status`, `error_code`, `error_message`).
`result`	object \| null	Dados da certidão. `null` quando `source_status.status` é `error`.

Os campos de result são os mesmos de cada endpoint: tipo (cndt, cnd_federal ou crf_fgts), status, status_raw, validade, validade_iso, emissao, emissao_iso, protocolo, pdf_base64 (vazio nesta consulta), url_verificacao, orgao e modo. Veja o significado de cada status em CNDT, CND Federal e CRF/FGTS.

`error_code` de uma certidão federal

`error_code`	Significado
`PROVIDER_ERROR`	O órgão emissor não respondeu agora. Consulte novamente em alguns minutos.
`EM_PROCESSAMENTO`	A emissão da CND Federal está em andamento. O `error_message` informa em quantos segundos consultar de novo.
`FEATURE_UNDER_REVIEW`	A certidão está temporariamente desativada para revisão.
`CPF_INVALIDO` / `CNPJ_INVALIDO`	O documento informado não é válido.

Exemplo de resposta

{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "document": "12345678000199",
  "document_type": "cnpj",
  "cnd_estaduais": {
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "document": "12345678000199",
    "document_type": "cnpj",
    "results": [
      {
        "uf": "MT",
        "source_status": { "status": "success", "error_code": "", "error_message": "" },
        "result": {
          "status": "negativa",
          "status_raw": "Certidao Negativa",
          "validade": "13/09/2026",
          "validade_iso": "2026-09-13",
          "emissao": "15/03/2026",
          "emissao_iso": "2026-03-15",
          "protocolo": "123456",
          "pdf_base64": "",
          "url_verificacao": "",
          "codigo_autenticacao": "2MBBTL922UUUB2LK"
        }
      },
      {
        "uf": "SP",
        "source_status": { "status": "success", "error_code": "", "error_message": "" },
        "result": {
          "status": "nao_contribuinte",
          "status_raw": "Nao Contribuinte",
          "validade": "",
          "validade_iso": "",
          "emissao": "",
          "emissao_iso": "",
          "protocolo": "",
          "pdf_base64": "",
          "url_verificacao": "",
          "codigo_autenticacao": ""
        }
      }
    ]
  },
  "certidoes_federais": [
    {
      "request_id": "550e8400-e29b-41d4-a716-446655440000",
      "document": "12345678000199",
      "document_type": "cnpj",
      "cached": false,
      "source_status": { "status": "success", "error_code": "", "error_message": "" },
      "result": {
        "tipo": "cndt",
        "status": "negativa",
        "status_raw": "Certidao Negativa de Debitos Trabalhistas",
        "validade": "16/04/2026",
        "validade_iso": "2026-04-16",
        "emissao": "18/10/2025",
        "emissao_iso": "2025-10-18",
        "protocolo": "123456789/2025",
        "pdf_base64": "",
        "url_verificacao": "",
        "orgao": "TST",
        "modo": "emissao"
      }
    },
    {
      "request_id": "550e8400-e29b-41d4-a716-446655440000",
      "document": "12345678000199",
      "document_type": "cnpj",
      "cached": false,
      "source_status": {
        "status": "error",
        "error_code": "EM_PROCESSAMENTO",
        "error_message": "A emissao desta certidao esta em andamento. Consulte novamente em cerca de 60 s."
      },
      "result": null
    },
    {
      "request_id": "550e8400-e29b-41d4-a716-446655440000",
      "document": "12345678000199",
      "document_type": "cnpj",
      "cached": true,
      "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",
        "pdf_base64": "",
        "url_verificacao": "",
        "orgao": "CEF",
        "modo": "consulta"
      }
    }
  ]
}

Trate cada certidão pelo próprio source_status: um erro numa delas (ou num estado) não invalida as outras. Para refazer só a que falhou, use o endpoint individual dela.

Cobrança

Cada chamada conta como 1 consulta, desde que pelo menos uma certidão (ou um estado) tenha retornado dado. Se todas as fontes falharem, a consulta não é cobrada. Os códigos de erro abaixo também não são cobrados.

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 recarga.
`API_KEY_ERROR`	403	API Key ausente, inválida ou revogada.
`ACESSO_NEGADO`	403	Chave sem acesso a este endpoint (chave demo).
`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.
`TIMEOUT`	504	A consulta passou de 90 segundos. Tente de novo; para uma resposta mais rápida, use `skip_estaduais=true`.

API de certidões (CND, CNDT, CRF) · Planos e preços

Esta pagina foi util?

Consultar Todas as Certidões

On this page