Para que serve
Busca protestos de títulos em cartórios de todo o país para o CPF ou CNPJ, em tempo real. O retorno agrupa os protestos por UF e por cartório e lista cada título com data, valor e o documento devedor. Na busca por CNPJ, matriz e filiais vêm juntas.
Ideal para
Por que usar
Cobertura nacional
Protestos de todos os estados numa chamada só.
Título a título
Data, valor e cartório de cada protesto, para negociar ou contestar.
Pronto para o seu sistema
Resposta em JSON estruturado, com os mesmos campos em toda consulta, para entrar direto no seu motor de regras.
Parâmetros
| Parâmetro | Descrição | Regra |
|---|---|---|
cpf | CPFCPF do pesquisado (informe CPF ou CNPJ). | Um de: cpf · cnpj |
cnpj | CNPJCNPJ do pesquisado (informe CPF ou CNPJ). | Um de: cpf · cnpj |
O que você recebe
9 campos no retorno, como o seu sistema recebe.
documentoConsultadoDado pessoalDocumento consultado
CPF ou CNPJ pesquisado, como a fonte o devolveu.
constamProtestosConstam protestos
Indica se há protesto em cartório para o documento.
numeroTotalProtestosTotal de protestos
Quantidade de títulos protestados.
valorTotalProtestosValor total protestado
Soma dos valores protestados.
protestosProtestos por UF
Protestos agrupados por UF, com total e valor por estado e a lista de cartórios.
protestos[].estadoUF
Sigla do estado.
protestos[].cartoriosCartórios
Cartórios com protesto, com cidade, quantidade e valor.
protestos[].cartorios[].titulosTítulos
Títulos protestados no cartório, com data, valor e documento devedor.
observacoesObservações
Observações registradas pela fonte.
Opções da chamada
assincrono=trueProcessa em segundo plano e devolve 202 com o consultaId.comprovante=trueEsta API não emite comprovante em PDF.
Códigos de resposta
200Sucesso — Consulta concluída; o retorno traz os dados da fonte.202Em processamento — Recupere em GET /api/Marketplace/Consulta/Resultado/{consultaId}. Recuperar não é cobrado.422Requisição inválida — Parâmetros validados antes de qualquer cobrança.429Limite simultâneo — Até 5 consultas simultâneas por cliente.503Em manutenção — A consulta está temporariamente indisponível; nada é cobrado.
Como é cobrado
- Débito por chamada — do saldo pré-pago ou do contrato pós-pago
- Preço exibido na plataforma antes de executar
- Falhas estornadas automaticamente
- Mesmo preço na plataforma e na API
curl "https://api.agrolitics.com.br/api/Marketplace/Consulta/protestos-nacional?cpf=00000000000" \ -H "X-Api-Key: $AGROLITICS_API_KEY"{ "metaDados": { "consultaId": "3f9c2a71-5b8e-4d1a-9c07-1e6b2f8a4d90", "apiIdentificador": "protestos-nacional", "apiNome": "Protestos Nacional", "fonte": "IEPTB · Cartórios de Protesto", "status": "Concluída", "resultado": "Sucesso", "tempoExecucaoMs": 1840, "assincrono": false, "urlComprovante": null }, "retorno": { /* dados da fonte — variam por consulta */ }}Perguntas frequentes sobre Protestos Nacional
Outras APIs para combinar
Ver catálogo completoSCR — Analítico
Resumo analítico do endividamento no SCR do Banco Central: modalidades, valores e situação das operações de crédito, por CPF ou CNPJ.
SCR — Detalhada
Posição detalhada do SCR do Banco Central por modalidade e vencimento, com opção de mês de competência (MM/aaaa).
Protestos Nacional - IEPTB Básica
Resumo dos protestos em cartórios de todo o país por CPF ou CNPJ: se constam protestos, quantidade e valor total e, por documento (com CNPJ, matriz e filiais), cartórios e cidades distintos e o valor de cada título.
Comece a integrar
Leve as fontes oficiais do agro para dentro do seu sistema
Crie sua conta e teste qualquer API na plataforma — ou fale com um especialista para desenhar a integração e o contrato ideais para o seu volume.
- APIs de fontes oficiais, com resposta padronizada
- Pague por chamada — sem mensalidade, falhas estornadas
- API do Dossiê BNIR com lotes de até 1.000 CARs
- Webhooks assinados e comprovante em PDF
- Conformidade LGPD — fontes oficiais, log auditável
Solicite uma Demonstração
Nossa equipe entrará em contato em breve.