Para que serve
Abre a posição do CPF ou CNPJ no SCR do Banco Central por modalidade de crédito e por faixa de vencimento: valores a liberar, a vencer, vencidos e em prejuízo, com responsabilidade total, operações em discordância ou sub judice e o mês de competência à sua escolha.
Ideal para
Por que usar
Dívida por modalidade e prazo
Veja onde está o compromisso e quando ele vence.
Competência escolhida
Compare meses diferentes informando mesAno (MM/aaaa).
Prova para auditoria
Comprovante em PDF da consulta, com data e hora, guardado por 90 dias para anexar ao processo de crédito ou de compliance.
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 |
mesAno | Mês de competênciaMês de competência da posição (MM/aaaa). Opcional — sem ele, a posição mais recente. | Opcional |
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.
mesReferenciaMês de referência
Competência (MM/aaaa) dos dados do SCR.
dataInicioRelacionamentoInício do relacionamento
Data do primeiro relacionamento com o sistema financeiro.
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.
quantidadeOperacoesDiscordanciaOperações em discordância
Operações contestadas pelo cliente.
quantidadeOperacoesSubjudiceOperações sub judice
Operações em discussão judicial.
responsabilidadeTotalResponsabilidade total
Soma das responsabilidades do documento no sistema financeiro.
riscoTotalRisco total
Risco total, direto e indireto.
riscoIndiretoVendorRisco indireto (vendor)
Responsabilidade indireta em operações vendor.
scoreScore
Pontuação de risco calculada a partir do SCR.
faixaRiscoClasse 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).
modalidadesModalidades de crédito
Uma linha por modalidade, com valores a liberar, a vencer, vencidos e prejuízo, por faixa de prazo.
percentualVolumeProcessadoVolume processado
Percentual do volume de operações processado pelo Banco Central na competência.
Opções da chamada
assincrono=trueProcessa em segundo plano e devolve 202 com o consultaId.comprovante=trueGera também o comprovante da consulta em PDF (custo adicional).
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-detalhada?cpf=00000000000" \ -H "X-Api-Key: $AGROLITICS_API_KEY"{ "metaDados": { "consultaId": "3f9c2a71-5b8e-4d1a-9c07-1e6b2f8a4d90", "apiIdentificador": "scr-detalhada", "apiNome": "SCR — Detalhada", "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 — Detalhada
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.
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.