Protestos - Brasil
Consulta a existência e os dados de Protestos de pessoas físicas e jurídicas em todo o Brasil
Requisição
curl -H "X-API-Key: SUA_CHAVE" \
"https://app.fontedata.com/api/v1/consulta/protestos-brasil?cpf=SEU_CPF"Parâmetros
| Nome | Tipo | Descrição | Exemplo |
|---|---|---|---|
| cpf condicional | CPF | CPF (somente números, 11 dígitos) | 000.000.000-00 |
| cnpj condicional | CNPJ | CNPJ (somente números, 14 dígitos) | 00.000.000/0000-00 |
Resposta
| Campo | Descrição |
|---|---|
| Cidade | Município do registro |
| Código da Cidade | Código identificador do município |
| Data do Protesto | Data de abertura do protesto |
| Documento Consultado | CPF ou CNPJ consultado |
| Estado | Nome do estado |
| Flag Protestos | Indica se há protestos: true ou false |
| Lista de Cartórios | Cartórios onde constam protestos |
| Lista de Protestos | Relação de protestos encontrados |
| Lista de Títulos | Títulos vinculados ao documento |
| Número de Protestos | Quantidade de protestos no cartório |
| Número Total de Protestos | Total geral de protestos |
| Número Total de Protestos na UF | Total de protestos no estado |
| Observações | Informações adicionais do registro |
| Valor Protestado | Valor do protesto no cartório |
| Valor Total dos Protestos | Soma total dos valores protestados |
| Valor Total dos Protestos no Cartório | Valor acumulado no cartório |
| Valor Total dos Protestos no Estado | Valor acumulado no estado |
Exemplo — 200 OK
{
"protestos": [
{
"estado": "string",
"cartorios": [
{
"cidade": "string",
"titulos": [
{
"documento": "string",
"dataProtesto": "string",
"valorProtestado": "string"
}
],
"codigoCidade": "string",
"numeroProtestos": "number",
"valorTotalProtestosCartorio": "string"
}
],
"numeroTotalProtestosUF": "number",
"valorTotalProtestosEstado": "string"
}
],
"observacoes": "string",
"constamProtestos": "boolean",
"documentoConsultado": "string",
"valorTotalProtestos": "string",
"numeroTotalProtestos": "number"
}Schema da resposta (JSON Schema)
JSON Schema
{
"type": "object",
"properties": {
"protestos": {
"type": [
"array",
"null"
],
"items": {
"type": [
"object",
"null"
],
"properties": {
"estado": {
"type": [
"string",
"null"
],
"description": "Nome do estado onde constam os protestos"
},
"cartorios": {
"type": [
"array",
"null"
],
"items": {
"type": [
"object",
"null"
],
"properties": {
"cidade": {
"type": [
"string",
"null"
],
"description": "Município onde está localizado o cartório"
},
"titulos": {
"type": [
"array",
"null"
],
"items": {
"type": [
"object",
"null"
],
"properties": {
"dataProtesto": {
"type": [
"string",
"null"
],
"description": "Data de abertura do protesto"
},
"valorProtestado": {
"type": [
"string",
"null"
],
"description": "Valor do título protestado"
}
}
},
"description": "Títulos vinculados ao cartório"
},
"codigoCidade": {
"type": [
"string",
"null"
],
"description": "Código identificador do município"
},
"numeroProtestos": {
"type": [
"number",
"null"
],
"description": "Quantidade de protestos registrados no cartório"
},
"valorTotalProtestosCartorio": {
"type": [
"string",
"null"
],
"description": "Valor acumulado dos protestos no cartório"
}
}
},
"description": "Lista de cartórios com protestos registrados"
},
"numeroTotalProtestosUF": {
"type": [
"number",
"null"
],
"description": "Total de protestos registrados no estado (UF)"
},
"valorTotalProtestosEstado": {
"type": [
"string",
"null"
],
"description": "Valor acumulado dos protestos no estado"
}
}
},
"description": "Lista de registros de protestos agrupados por estado"
},
"observacoes": {
"type": [
"string",
"null"
],
"description": "Observações e informações adicionais do registro"
},
"constamProtestos": {
"type": [
"boolean",
"null"
],
"format": "bool",
"description": "Indica se há protestos: true ou false"
},
"documentoConsultado": {
"type": [
"string",
"null"
],
"description": "CPF ou CNPJ que foi consultado"
},
"valorTotalProtestos": {
"type": [
"string",
"null"
],
"description": "Valor total somado de todos os protestos"
},
"numeroTotalProtestos": {
"type": [
"number",
"null"
],
"description": "Quantidade total de protestos encontrados"
}
}
}Códigos de erro
| Código | Mensagem | Quando acontece |
|---|---|---|
| 400 | Requisição Inválida | Parâmetros ausentes ou com formato incorreto. |
| 401 | Não Autenticado | Credenciais inválidas ou não fornecidas. |
| 403 | Não Autorizado | Saldo insuficiente para realizar a consulta. |
| 404 | Não Encontrado | Recurso solicitado não localizado no servidor. |
| 408 | Tempo Esgotado | O servidor não concluiu a resposta dentro do prazo estabelecido. |
| 500 | Erro Interno | Falha interna ao processar a requisição. Entre em contato com o suporte. |
| 503 | Serviço em Manutenção | A consulta está temporariamente indisponível. Entre em contato com o suporte. |
Quando usar
- Onboarding de clientes e fornecedores com verificação de histórico de protestos.
- Análise de risco e crédito com base em ocorrências de protesto registradas nos cartórios.
- Identificação de protestos de pessoas físicas e jurídicas em todo o território nacional.
- Apoio a processos de due diligence, compliance e prevenção a fraudes.
- Suporte para decisões de crédito com dados atualizados dos cartórios brasileiros.
Protestos Brasil
Verifica a existência e detalha ocorrências de protesto de pessoas físicas e jurídicas em âmbito nacional, com base nos registros cartoriais disponíveis.
Endpoint
GET /api/v1/consulta/protestos-brasil?cpf={CPF}
GET /api/v1/consulta/protestos-brasil?cnpj={CNPJ}
Autenticação por header X-API-Key: <sua-chave>.
Esta consulta não gera comprovantes.
Erros Comuns
| Código | Descrição |
|---|---|
| 400 | Requisição inválida: parâmetros ausentes ou incorretos. |
| 401 | Não autenticado: credenciais inválidas ou ausentes. |
| 403 | Não autorizado: saldo insuficiente para realizar a consulta. |
| 404 | Não encontrado: recurso solicitado não localizado. |
| 408 | Tempo esgotado: o servidor não respondeu dentro do prazo. |
| 500 | Erro interno: falha ao processar a requisição. Entre em contato com o suporte. |
| 503 | Serviço em manutenção: consulta temporariamente indisponível. |