# CADIN Estadual

> Consulta o CADIN Estadual (Cadastro Informativo de Inadimplência das Secretarias da Fazenda estaduais) por CPF ou CNPJ, roteando automaticamente pela UF informada — inclusive São Paulo. Um único endpoint para todos os estados. Para o CADIN MUNICIPAL de São Paulo (Prefeitura), use o endpoint cadin-prefeitura-SP.

- **Consulta:** `cadin-estadual`
- **Categoria:** Fiscal
- **Preço:** R$ 0,51 por consulta
- **Endpoint:** `POST https://app.fontedata.com/api/v1/consulta/cadin-estadual`
- **Autenticação:** header `X-API-Key`
- **Página:** https://fontedata.com/docs/fiscal/cadin-estadual

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> Consulta a situação de um CPF ou CNPJ no **CADIN Estadual** — o Cadastro Informativo de Créditos não Quitados mantido pelas **Secretarias da Fazenda estaduais** (dívida ativa estadual). Informe a **UF** desejada; a cobertura contempla os estados atendidos, inclusive **São Paulo**.
>
> > ⚠️ Este é o CADIN **estadual**. Para o CADIN **Municipal de São Paulo** (Prefeitura), use o endpoint `cadin-prefeitura-SP`. Para dívidas com a **União** (federal), veja `pgfn-devedores` e as CNDs federais.

## Requisição

### cURL

```bash
curl -X POST -H "X-API-Key: SUA_CHAVE" \
  "https://app.fontedata.com/api/v1/consulta/cadin-estadual?uf=SP&cpf=SEU_CPF"
```

### Python

```python
import requests

resp = requests.post(
    "https://app.fontedata.com/api/v1/consulta/cadin-estadual",
    params={"uf": "SP", "cpf": "SEU_CPF"},
    headers={"X-API-Key": "SUA_CHAVE"},
    timeout=60,
)
resp.raise_for_status()
print(resp.json())
```

### Node.js

```javascript
const url = new URL("https://app.fontedata.com/api/v1/consulta/cadin-estadual");

url.search = new URLSearchParams({
  "uf": "SP",
  "cpf": "SEU_CPF"
}).toString();

const resp = await fetch(url, {
  method: "POST",
  headers: { "X-API-Key": "SUA_CHAVE" }
});

if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
console.log(await resp.json());
```

## Parâmetros

Informe `cpf` ou `cnpj`.

| Nome | Tipo | Obrigatório | Descrição | Exemplo |
|---|---|---|---|---|
| `uf` | texto | sim | UF da consulta (sigla de 2 letras). A cobertura contempla os estados atendidos, incluindo São Paulo. | `SP` |
| `cpf` | CPF | condicional | CPF (somente números, 11 dígitos) | formato: 000.000.000-00 |
| `cnpj` | CNPJ | condicional | CNPJ (somente números, 14 dígitos) | formato: 00.000.000/0000-00 |

## Resposta

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> - **documentoConsultado**: documento consultado
> - **nome**: nome/razão social
> - **uf**: estado consultado
> - **possuiPendencias**: `true` se há pendências
> - **totalPendencias**: quantidade de pendências
> - **pendencias**: lista detalhada (entidade, órgão, tipo, data, processo, local de regularização)
> - **status**: situação do registro na fonte estadual
> - **codigoDeclaracao**: identificador da declaração
> - Campos adicionais conforme o estado (`valorTotal`, `dataValidade`, `numeroCertidao`)

### Exemplo de resposta

```json
{
  "uf": "string",
  "nome": "string",
  "status": "string",
  "pendencias": [],
  "valorTotal": null,
  "dataValidade": null,
  "numeroCertidao": null,
  "totalPendencias": "number",
  "codigoDeclaracao": null,
  "possuiPendencias": "boolean",
  "documentoConsultado": "string"
}
```

### Schema da resposta

```json
{
  "type": "object",
  "properties": {
    "uf": {
      "type": [
        "string",
        "null"
      ],
      "description": "Unidade Federativa (estado) referente ao registro."
    },
    "nome": {
      "type": [
        "string",
        "null"
      ],
      "description": "Nome do indivíduo ou registro consultado."
    },
    "status": {
      "type": [
        "string",
        "null"
      ],
      "description": "Detalhes sobre o status do registro em questão."
    },
    "pendencias": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "properties": {
          "orgao": {
            "type": [
              "string",
              "null"
            ],
            "description": "Informações do órgão expedidor."
          },
          "entidade": {
            "type": [
              "string",
              "null"
            ],
            "description": "Nome da entidade com pendência."
          },
          "tipoPendencia": {
            "type": [
              "string",
              "null"
            ],
            "description": "Tipo de pendência registrada."
          },
          "numeroProcesso": {
            "type": [
              "string",
              "null"
            ],
            "description": "Número do processo associado à pendência."
          },
          "dataInclusaoCADIN": {
            "type": [
              "string",
              "null"
            ],
            "description": "Data de inclusão do documento no cadastro."
          },
          "localRegularizacao": {
            "type": [
              "string",
              "null"
            ],
            "description": "Local para regularização da pendência."
          },
          "quantidadePendencias": {
            "type": [
              "number",
              "null"
            ],
            "description": "Quantidade de pendências neste registro."
          }
        }
      },
      "description": "Lista de pendências registradas."
    },
    "valorTotal": {
      "type": [
        "number",
        "null"
      ],
      "description": "Valor total de pendências."
    },
    "dataConsulta": {
      "type": [
        "string",
        "null"
      ],
      "description": "Data e hora da consulta realizada."
    },
    "dataValidade": {
      "type": [
        "string",
        "null"
      ],
      "description": "Data de validade do resultado da consulta."
    },
    "numeroCertidao": {
      "type": [
        "string",
        "null"
      ],
      "description": "Número do certificado de consulta."
    },
    "totalPendencias": {
      "type": [
        "number",
        "null"
      ],
      "description": "Total de pendências do documento consultado."
    },
    "codigoDeclaracao": {
      "type": [
        "string",
        "null"
      ],
      "description": "Código de identificação da declaração."
    },
    "possuiPendencias": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "Indica se existem pendências registradas."
    },
    "documentoConsultado": {
      "type": [
        "string",
        "null"
      ],
      "description": "Documento (CPF ou CNPJ) consultado."
    }
  }
}
```

## Observações

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> - Um documento por requisição (CPF ou CNPJ, não ambos).
> - A formatação do documento é normalizada automaticamente.
> - A cobertura por estado depende da disponibilidade na fonte oficial; UFs sem base estadual disponível retornam erro informativo.

---

Página em HTML: https://fontedata.com/docs/fiscal/cadin-estadual
Catálogo completo: https://fontedata.com/docs
OpenAPI (JSON): https://app.fontedata.com/api/v1/openapi.json
Conectar via MCP: https://fontedata.com/docs/mcp