Para que serve
Responde rápido se constam protestos em cartórios de todo o país para o CPF ou CNPJ, com quantidade e valor total. Por documento (no CNPJ, a matriz e cada filial), traz os totais, quantos cartórios e cidades diferentes e o valor de cada título.
Ideal para
Por que usar
Triagem de baixo custo
Saiba se há protesto antes de pedir a consulta completa.
Matriz e filiais separadas
Um resumo por documento quando a busca é por CNPJ.
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). O resumo traz a matriz e cada filial. | Um de: cpf · cnpj |
O que você recebe
11 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.
cnaeDevedorCNAE
Código e descrição da atividade econômica.
documentosProtestos por documento
Um item por documento (com CNPJ, matriz e cada filial), com totais, cartórios e cidades distintos.
documentos[].quantidadeCartoriosDistintosCartórios distintos
Quantidade de cartórios diferentes com protesto.
documentos[].quantidadeCidadesDistintasCidades distintas
Quantidade de cidades diferentes com protesto.
documentos[].titulosTítulos
Títulos protestados no cartório, com data, valor e documento devedor. Aqui cada título traz só o valor protestado.
observacoesObservações
Observações registradas pela fonte.
dataConsultaData da consulta
Data e hora em que a fonte foi consultada.
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-ieptb-basica?cpf=00000000000" \ -H "X-Api-Key: $AGROLITICS_API_KEY"{ "metaDados": { "consultaId": "3f9c2a71-5b8e-4d1a-9c07-1e6b2f8a4d90", "apiIdentificador": "protestos-nacional-ieptb-basica", "apiNome": "Protestos Nacional - IEPTB Básica", "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 - IEPTB Básica
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
Protestos de títulos em cartórios de todo o país, em tempo real, por CPF ou CNPJ.
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.