NovoCentral de APIs
Crédito

SCR — Detalhada

Posição detalhada do SCR do Banco Central por modalidade e vencimento, com opção de mês de competência (MM/aaaa).

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

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

Concessão de créditoAnálise de grandes exposiçõesRevisão periódica de carteiraRecuperação de crédito

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

    Documento consultado

    CPF ou CNPJ pesquisado, como a fonte o devolveu.

  • mesReferencia

    Mês de referência

    Competência (MM/aaaa) dos dados do SCR.

  • dataInicioRelacionamento

    Início do relacionamento

    Data do primeiro relacionamento com o sistema financeiro.

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

  • quantidadeOperacoesDiscordancia

    Operações em discordância

    Operações contestadas pelo cliente.

  • quantidadeOperacoesSubjudice

    Operações sub judice

    Operações em discussão judicial.

  • responsabilidadeTotal

    Responsabilidade total

    Soma das responsabilidades do documento no sistema financeiro.

  • riscoTotal

    Risco total

    Risco total, direto e indireto.

  • riscoIndiretoVendor

    Risco indireto (vendor)

    Responsabilidade indireta em operações vendor.

  • score

    Score

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

  • faixaRisco

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

  • modalidades

    Modalidades de crédito

    Uma linha por modalidade, com valores a liberar, a vencer, vencidos e prejuízo, por faixa de prazo.

  • percentualVolumeProcessado

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

Perguntas frequentes sobre SCR — Detalhada

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.