Consultar CND em Todos os Estados

Consulta a Certidão Negativa de Débitos (CND ICMS) em todos os 27 estados simultaneamente.

GET /api/consultar-cnd-todos

Consulta a Certidão Negativa de Débitos de ICMS (CND) de um contribuinte em todos os 27 estados brasileiros simultaneamente. Retorna um array com o resultado de cada UF, permitindo uma visão completa da situação fiscal do contribuinte em todo o país.

Este endpoint pode demorar mais para responder. Configure um timeout adequado na sua aplicação.

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.

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

Exemplos de código

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

const response = await fetch(
  "https://api.fiscalapi.com.br/api/consultar-cnd-todos?cnpj=12345678000199",
  { headers: { "X-API-Key": "fapi_sua_chave_aqui" } }
);
const data = await response.json();
data.results.forEach((r) => {
  console.log(`${r.uf}: ${r.result?.status ?? r.source_status.status}`);
});

import requests

response = requests.get(
    "https://api.fiscalapi.com.br/api/consultar-cnd-todos",
    headers={"X-API-Key": "fapi_sua_chave_aqui"},
    params={"cnpj": "12345678000199"},
    timeout=120,
)
data = response.json()
for r in data["results"]:
    status = r["result"]["status"] if r["result"] else r["source_status"]["status"]
    print(f"{r['uf']}: {status}")

$response = Http::timeout(120)->withHeaders([
    'X-API-Key' => 'fapi_sua_chave_aqui',
])->get('https://api.fiscalapi.com.br/api/consultar-cnd-todos', [
    '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/consultar-cnd-todos?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`.
`results`	array	Lista de resultados por UF.

Campos de cada resultado (`results[]`)

Campo	Tipo	Descrição
`uf`	string	Sigla do estado.
`source_status`	object	Status da consulta naquele estado (`status`, `error_code`, `error_message`).
`result`	object \| null	Dados da certidão (mesma estrutura do endpoint Consultar CND por UF).

Exemplo de resposta

{
  "request_id": "uuid",
  "document": "12345678000199",
  "document_type": "cnpj",
  "results": [
    {
      "uf": "MT",
      "source_status": { "status": "success" },
      "result": {
        "status": "negativa",
        "status_raw": "Certidao Negativa",
        "validade": "2026-09-13",
        "emissao": "2026-03-13",
        "protocolo": "123456",
        "codigo_autenticacao": "2MBBTL922UUUB2LK"
      }
    },
    {
      "uf": "SP",
      "source_status": { "status": "success" },
      "result": {
        "status": "nao_contribuinte",
        "status_raw": "Nao Contribuinte"
      }
    }
  ]
}

Estados em que o contribuinte não possui inscrição estadual retornarão status: "nao_contribuinte". Isso é esperado e não indica erro. Consulte os valores de status da CND para entender cada status.

Códigos de erro

Código	HTTP Status	Descrição
`PARAMETRO_AUSENTE`	400	Nenhum documento (cpf ou cnpj) foi informado.
`ERRO_INTERNO`	500	Erro interno no servidor.

Esta pagina foi util?

Consultar CND em Todos os Estados

On this page