NovoCentral de APIs
Crédito

SCR — 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.

Fonte
SCR · Banco Central do Brasil
Entrada
CPF ou CNPJ
Comprovante PDF
Não emite
Preço
R$ 3,90 por chamada
GEThttps://api.agrolitics.com.br/api/Marketplace/Consulta/scr-analitico?cpf=00000000000

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

Concessão de créditoDefinição de limitesRevisão periódica de carteira

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â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

15 campos no retorno, como o seu sistema recebe.

  • documentoConsultadoDado pessoal

    Documento consultado

    CPF ou CNPJ pesquisado, como a fonte o devolveu.

  • quantidadeInstituicoes

    Instituições financeiras

    Quantidade de instituições com que há operação.

  • quantidadeOperacoes

    Operações de crédito

    Quantidade de operações de crédito registradas.

  • relacionamentos

    Relacionamento

    Faixa de tempo de relacionamento com o sistema financeiro.

  • volume

    Volume

    Faixa de volume das operações.

  • situacao

    Situação

    Classificação da situação das operações.

  • perfil

    Perfil

    Perfil de endividamento.

  • score

    Score

    Pontuação de risco calculada a partir do SCR.

  • classeRisco

    Classe de risco

    Classe ou faixa de risco do documento.

  • carteiraCredito

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

  • percentualCategoria

    Distribuição por categoria

    Percentual da dívida em cada categoria de crédito.

  • percentualVencido

    Percentual vencido

    Percentual vencido em cada categoria de crédito.

  • percentualPrazo

    Distribuição por prazo

    Percentual da dívida no curto, médio e longo prazo.

  • percentualEvolucaoCompromisso

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

Perguntas frequentes sobre SCR — Analítico

Sim. As normas do Banco Central exigem autorização prévia da pessoa ou empresa para a consulta ao SCR. Guarde esse consentimento junto do processo.

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.