Para que serve
Resume o endividamento do CPF ou CNPJ no SCR, o Sistema de Informações de Crédito do Banco Central: quantas instituições e operações, carteira a vencer e vencida, score, classe de risco e como a dívida se distribui por categoria e por prazo.
Ideal para
Por que usar
Endividamento em todo o sistema
Veja a dívida com todas as instituições, não só com a sua.
Leitura rápida de risco
Score, classe de risco e percentuais prontos para a política de crédito.
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
15 campos no retorno, como o seu sistema recebe.
documentoConsultadoDado pessoalDocumento consultado
CPF ou CNPJ pesquisado, como a fonte o devolveu.
quantidadeInstituicoesInstituições financeiras
Quantidade de instituições com que há operação.
quantidadeOperacoesOperações de crédito
Quantidade de operações de crédito registradas.
relacionamentosRelacionamento
Faixa de tempo de relacionamento com o sistema financeiro.
volumeVolume
Faixa de volume das operações.
situacaoSituação
Classificação da situação das operações.
perfilPerfil
Perfil de endividamento.
scoreScore
Pontuação de risco calculada a partir do SCR.
classeRiscoClasse de risco
Classe ou faixa de risco do documento.
carteiraCreditoCarteira de crédito
Valores a vencer e vencidos (na versão detalhada, também total, limite e prejuízo).
indiceÍndices de uso
Índices de uso de crédito: total, cartão, crédito pessoal e cheque especial.
percentualCategoriaDistribuição por categoria
Percentual da dívida em cada categoria de crédito.
percentualVencidoPercentual vencido
Percentual vencido em cada categoria de crédito.
percentualPrazoDistribuição por prazo
Percentual da dívida no curto, médio e longo prazo.
percentualEvolucaoCompromissoEvolução do compromisso
Variação do compromisso total, de maior risco, de financiamentos e de cartão.
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/scr-analitico?cpf=00000000000" \ -H "X-Api-Key: $AGROLITICS_API_KEY"{ "metaDados": { "consultaId": "3f9c2a71-5b8e-4d1a-9c07-1e6b2f8a4d90", "apiIdentificador": "scr-analitico", "apiNome": "SCR — Analítico", "fonte": "SCR · Banco Central do Brasil", "status": "Concluída", "resultado": "Sucesso", "tempoExecucaoMs": 1840, "assincrono": false, "urlComprovante": null }, "retorno": { /* dados da fonte — variam por consulta */ }}Perguntas frequentes sobre SCR — Analítico
Outras APIs para combinar
Ver catálogo completoSCR — 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.
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.