# Protestos - São Paulo

> Consulta protestos de pessoas físicas e jurídicas registrados em São Paulo, fornecendo detalhes dos cartórios e valores protestados para análise de risco e validação de identidade.

- **Consulta:** `protestos-sp`
- **Categoria:** Crédito & Score
- **Preço:** R$ 0,63 por consulta
- **Endpoint:** `GET https://app.fontedata.com/api/v1/consulta/protestos-sp`
- **Autenticação:** header `X-API-Key`
- **Página:** https://fontedata.com/docs/credito-e-score/protestos-sp

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> Permite consultar e validar informações sobre protestos registrados no estado de São Paulo. Útil para avaliação de risco, análise de crédito, verificação de antecedentes e processos de onboarding. A consulta fornece detalhes completos dos registros existentes, incluindo cartórios envolvidos, datas e valores protestados.
>
> Os principais casos de uso incluem: validação de identidade em processos KYC, análise de risco creditício, prevenção de fraude em aberturas de conta e integração com fluxos de onboarding de clientes e fornecedores. Os dados retornados são atualizados e padronizados, facilitando decisões mais precisas e com menor fricção operacional.

## Requisição

### cURL

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

### Python

```python
import requests

resp = requests.get(
    "https://app.fontedata.com/api/v1/consulta/protestos-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/protestos-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 resposta estruturada inclui os seguintes campos:
>
> - **constamProtestos**: Indicador booleano informando se existem protestos associados ao documento consultado.
> - **documentoConsultado**: Reprodução do documento utilizado na consulta.
> - **protestos**: Array contendo os registros de protesto encontrados, incluindo dados de cada cartório, datas de registro e valores protestados por instituição.
> - **totalNumProtestos**: Quantidade total de protestos registrados para o documento consultado.
> - **valorTotalProtestos**: Montante agregado de todos os valores protestados.
> - **observacoes**: Informações complementares ou alertas relevantes sobre o resultado da consulta.
>
> Cada registro de protesto detalha: localização (cidade, estado), informações do cartório (nome, endereço, telefone, código de identificação), data de atualização, quantidade e valor total de protestos por cartório, e histórico de protestos individuais com suas respectivas datas e valores.

### Exemplo de resposta

```json
{
  "protestos": [],
  "observacoes": "string",
  "constamProtestos": "boolean",
  "totalNumProtestos": "number",
  "documentoConsultado": "string",
  "valorTotalProtestos": "string"
}
```

### Schema da resposta

```json
{
  "type": "object",
  "properties": {
    "protestos": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "properties": {
          "estado": {
            "type": [
              "string",
              "null"
            ],
            "description": "Unidade federativa do protesto."
          },
          "cartoriosProtesto": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "nome": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Nome do cartório."
                },
                "cidade": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Cidade do cartório."
                },
                "endereco": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Endereço do cartório."
                },
                "protesto": {
                  "type": [
                    "array",
                    "null"
                  ],
                  "items": {
                    "type": "object",
                    "properties": {
                      "dataProtesto": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Data de abertura do protesto."
                      },
                      "valorProtestado": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Valor do protesto registrado."
                      }
                    }
                  },
                  "description": "Detalhes dos protestos neste cartório."
                },
                "telefone": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Telefone de contato do cartório."
                },
                "observacao": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Observações adicionais sobre o cartório."
                },
                "codigoCidade": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Código identificador da cidade."
                },
                "numProtestos": {
                  "type": [
                    "number",
                    "null"
                  ],
                  "description": "Número de protestos neste cartório."
                },
                "codigoCartorio": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Código identificador do cartório."
                },
                "possuiAnuencia": {
                  "type": [
                    "boolean",
                    "null"
                  ],
                  "description": "Indica se o cartório possui anuência."
                },
                "dataAtualizacao": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Data da última atualização dos dados do cartório."
                },
                "valorTotalProtestosCartorio": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Valor total dos protestos neste cartório."
                }
              }
            },
            "description": "Lista de cartórios com protestos registrados."
          },
          "pesquisaEfetuadaEm": {
            "type": [
              "string",
              "null"
            ],
            "description": "Data e hora da realização da pesquisa."
          },
          "totalNumProtestosUf": {
            "type": [
              "number",
              "null"
            ],
            "description": "Total de protestos na unidade federativa."
          },
          "pesquisaRetroativaAte": {
            "type": [
              "string",
              "null"
            ],
            "description": "Data limite da pesquisa retroativa."
          },
          "valorTotalProtestosEstado": {
            "type": [
              "string",
              "null"
            ],
            "description": "Valor total dos protestos na unidade federativa."
          }
        }
      },
      "description": "Lista de protestos encontrados."
    },
    "observacoes": {
      "type": [
        "string",
        "null"
      ],
      "description": "Observações gerais sobre a consulta."
    },
    "dataConsulta": {
      "type": [
        "string",
        "null"
      ],
      "description": "Data e hora em que a consulta foi realizada."
    },
    "constamProtestos": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "Indica se existem protestos registrados para o documento consultado."
    },
    "totalNumProtestos": {
      "type": [
        "number",
        "null"
      ],
      "description": "Número total de protestos encontrados."
    },
    "documentoConsultado": {
      "type": [
        "string",
        "null"
      ],
      "description": "CPF ou CNPJ utilizado na consulta."
    },
    "valorTotalProtestos": {
      "type": [
        "string",
        "null"
      ],
      "description": "Valor total acumulado dos protestos."
    }
  }
}
```

## 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.
>
> - Envie apenas um documento por requisição para garantir processamento adequado.
> - A consulta retorna informações exclusivas do estado de São Paulo; consultas para outros estados requerem endpoints específicos.
> - Os dados refletem o status no momento da consulta e são regularmente sincronizados com os registros oficiais.
> - Recomenda-se integrar esta consulta em fluxos de análise de risco para decisões mais informadas sobre concessão de crédito ou abertura de contas.
> - A resposta inclui timestamps completos para auditoria e rastreabilidade das operações realizadas.

---

Página em HTML: https://fontedata.com/docs/credito-e-score/protestos-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