Debitado do seu saldo a cada chamada cobrada. Autenticação pelo header X-API-Key. Veja como obter a chave.
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.
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.
{
"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
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.
Integrar
OpenAPI (JSON) ↗ — importe a URL
no Postman ou no Insomnia para gerar a coleção com todos os endpoints. Também dá para consultar
pelo chat: conecte via MCP. Esta página em Markdown.