NovoCentral de APIs
Crédito

Protestos Nacional

Protestos de títulos em cartórios de todo o país, em tempo real, por CPF ou CNPJ.

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

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

Análise de créditoCobrançaHomologação de fornecedoresDue diligence

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

O que você recebe

9 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.

  • protestos

    Protestos por UF

    Protestos agrupados por UF, com total e valor por estado e a lista de cartórios.

  • protestos[].estado

    UF

    Sigla do estado.

  • protestos[].cartorios

    Cartórios

    Cartórios com protesto, com cidade, quantidade e valor.

  • protestos[].cartorios[].titulos

    Títulos

    Títulos protestados no cartório, com data, valor e documento devedor.

  • observacoes

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

Perguntas frequentes sobre Protestos Nacional

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.