NovoCentral de APIs
Crédito

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.

Fonte
IEPTB · Cartórios de Protesto
Entrada
CPF ou CNPJ
Comprovante PDF
Não emite
Preço
R$ 2,95 por chamada
GEThttps://api.agrolitics.com.br/api/Marketplace/Consulta/protestos-nacional-ieptb-basica?cpf=00000000000

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

Triagem de créditoCadastro de clientesRevisão de carteira

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âmetroDescriçãoRegra
cpfCPFCPF do pesquisado (informe CPF ou CNPJ).Um de: cpf · cnpj
cnpjCNPJCNPJ 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 pessoal

    Documento consultado

    CPF ou CNPJ pesquisado, como a fonte o devolveu.

  • constamProtestos

    Constam protestos

    Indica se há protesto em cartório para o documento.

  • numeroTotalProtestos

    Total de protestos

    Quantidade de títulos protestados.

  • valorTotalProtestos

    Valor total protestado

    Soma dos valores protestados.

  • cnaeDevedor

    CNAE

    Código e descrição da atividade econômica.

  • documentos

    Protestos por documento

    Um item por documento (com CNPJ, matriz e cada filial), com totais, cartórios e cidades distintos.

  • documentos[].quantidadeCartoriosDistintos

    Cartórios distintos

    Quantidade de cartórios diferentes com protesto.

  • documentos[].quantidadeCidadesDistintas

    Cidades distintas

    Quantidade de cidades diferentes com protesto.

  • documentos[].titulos

    Títulos

    Títulos protestados no cartório, com data, valor e documento devedor. Aqui cada título traz só o valor protestado.

  • observacoes

    Observações

    Observações registradas pela fonte.

  • dataConsulta

    Data 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"
Resposta · envelope padrão
200 OK
{  "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 */ }}
Referência completa no Swagger

Perguntas frequentes sobre Protestos Nacional - IEPTB Básica

Sim. É uma resposta concluída: constamProtestos vem false e a lista vem vazia.

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.

Sem compromisso. Seus dados são usados só para este contato, conforme a Política de Privacidade.