# CADIN - São Paulo

> [LEGADO — prefira o cadin-estadual] CADIN Estadual de São Paulo (Secretaria da Fazenda de SP), por CPF ou CNPJ.

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

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> Este endpoint consulta a situação de um Cadastro Informativo de Inadimplência (CADIN) junto à Secretaria da Fazenda do Estado de São Paulo. Permite verificar se um CPF está registrado no cadastro e identifica possíveis débitos inscritos em dívida ativa.
>
> A consulta retorna informações sobre pendências, incluindo entidades envolvidas, datas de inclusão e locais para regularização. O serviço mantém dados atualizados e padronizados.
>
> **Casos de uso:**
> - Verificação de pendências junto ao setor público
> - Compliance em processos de contratação e licitações
> - Avaliação de risco creditício em operações B2B
> - Monitoramento contínuo de parceiros e fornecedores
>
> **Benefícios:**
> - Evita seleção inadequada de fornecedores ou clientes
> - Reduz exposição a penalidades por violação de compliance
> - Aumenta segurança nas decisões de crédito
> - Fornece informações atualizadas e confiáveis

## Requisição

### cURL

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

### Python

```python
import requests

resp = requests.get(
    "https://app.fontedata.com/api/v1/consulta/cadin-sp",
    params={"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-sp");

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

const resp = await fetch(url, {
  method: "GET",
  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 |
|---|---|---|---|---|
| `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.
>
> A consulta retorna um objeto com os seguintes campos:
>
> | Campo                  | Tipo     | Descrição |
> |------------------------|----------|-----------|
> | `nome`                 | string   | Nome do indivíduo consultado. |
> | `documentoConsultado`  | string   | CPF que foi consultado. |
> | `codigoDeclaracao`     | string   | Código identificador da declaração retornada. |
> | `possuiPendencias`     | boolean  | Indica se existem pendências registradas (verdadeiro/falso). |
> | `dataConsulta`         | string   | Data e hora em que a consulta foi realizada. |
> | `totalPendencias`      | integer  | Quantidade total de pendências encontradas. |
> | `status`               | string   | Situação do registro consultado. |
> | `pendencias`           | array    | Lista detalhada das pendências, contendo: entidade credora, data de inclusão no CADIN, quantidade de pendências por entidade e local de regularização. |

### Exemplo de resposta

```json
{
  "nome": "string",
  "status": "string",
  "pendencias": [],
  "totalPendencias": "number",
  "codigoDeclaracao": "string",
  "possuiPendencias": "boolean",
  "documentoConsultado": "string"
}
```

### Schema da resposta

```json
{
  "type": "object",
  "properties": {
    "nome": {
      "type": [
        "string",
        "null"
      ],
      "description": "Nome do indivíduo ou registro consultado."
    },
    "status": {
      "type": [
        "string",
        "null"
      ],
      "description": "Status detalhado do registro consultado."
    },
    "pendencias": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "properties": {
          "entidade": {
            "type": [
              "string",
              "null"
            ],
            "description": "Nome da entidade responsável pela pendência."
          },
          "dataInclusaoCADIN": {
            "type": [
              "string",
              "null"
            ],
            "description": "Data de inclusão da pendência no cadastro."
          },
          "localRegularizacao": {
            "type": [
              "string",
              "null"
            ],
            "description": "Endereço ou local para regularização da pendência."
          },
          "quantidadePendencias": {
            "type": [
              "number",
              "null"
            ],
            "description": "Quantidade de pendências registradas para a entidade."
          }
        }
      },
      "description": "Lista de pendências encontradas."
    },
    "totalPendencias": {
      "type": [
        "number",
        "null"
      ],
      "description": "Número total de pendências encontradas."
    },
    "codigoDeclaracao": {
      "type": [
        "string",
        "null"
      ],
      "description": "Código único de identificação da consulta realizada."
    },
    "possuiPendencias": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "Indicador se existem pendências para o documento consultado."
    },
    "documentoConsultado": {
      "type": [
        "string",
        "null"
      ],
      "description": "CPF ou CNPJ consultado nesta requisição."
    }
  }
}
```

## Códigos de erro

| Código | Mensagem | Quando acontece |
|---|---|---|
| `400` | Requisição Inválida | a requisição está incorreta ou os parâmetros são inválidos. |
| `401` | Não Autenticado | o usuário não forneceu as credenciais corretas para acessar o recurso. |
| `403` | Não Autorizado | o servidor recebeu a requisição, mas se negou a autorizá-la por conta de saldo indisponível. |
| `404` | Não Encontrado | o servidor não encontrou uma representação atual do recurso solicitado. |
| `408` | Tempo Esgotado | o servidor não conseguiu retornar a requisição no prazo estabelecido. |
| `500` | Falha ao Realizar Consulta | o servidor não conseguiu processar a requisição com sucesso. Por favor, entre em contato com o nosso suporte. |
| `503` | Consulta em Manutenção | a consulta requisitada está em manutenção. Por favor, entre em contato com o nosso suporte. |

## Observações

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> - A consulta processa um único CPF por requisição.
> - Os dados são atualizados regularmente junto à fonte oficial.
> - O serviço gera comprovantes em PDF que podem ser solicitados para fins de auditoria ou conformidade.
> - Em caso de dúvidas sobre interpretação dos resultados, recomenda-se consultar diretamente os órgãos estaduais responsáveis pelo CADIN.
>
> > ℹ️ **Endpoint legado.** Prefira o `cadin-estadual`, que unifica todos os estados (inclusive SP) num só endpoint. Este segue ativo para compatibilidade.

---

Página em HTML: https://fontedata.com/docs/fiscal/cadin-sp
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