Histórico de Crédito - SCR

GET https://app.fontedata.com/api/v1/consulta/credito-scr-resumo
R$ 7,07 por consulta

Debitado do seu saldo a cada chamada cobrada. Autenticação pelo header X-API-Key. Veja como obter a chave.

Este endpoint permite consultar informações detalhadas do Sistema de Informações de Créditos (SCR) mantido pelo Banco Central do Brasil. O SCR consolida dados sobre operações de crédito de pessoas e empresas que possuem exposição direta de risco igual ou superior a R$ 200,00, sendo atualizado mensalmente pelas instituições financeiras participantes.

Através dessa consulta, você obtém um panorama completo do perfil de crédito de um cliente ou fornecedor, incluindo análise de risco, histórico de relacionamento, composição de modalidades de crédito, e exposição total de responsabilidade. As informações integram dados agregados de todas as operações registradas no sistema central do BACEN.

O serviço é indicado para processos de avaliação de risco de crédito, onboarding de clientes e fornecedores, e automação de fluxos de compliance e análise de exposição.

Requisição

curl -H "X-API-Key: SUA_CHAVE" \
  "https://app.fontedata.com/api/v1/consulta/credito-scr-resumo?cpf=SEU_CPF"

Parâmetros

Informe cpf ou cnpj.

NomeTipoDescriçãoExemplo
cpf condicionalCPFCPF (somente números, 11 dígitos)000.000.000-00
cnpj condicionalCNPJCNPJ (somente números, 14 dígitos)00.000.000/0000-00

Resposta

A resposta retorna dados estruturados em dois níveis: informações gerais e detalhamento por modalidade de crédito.

Informações Gerais:

  • Score de avaliação da entidade
  • Faixa de risco e risco total
  • Quantidade de instituições credoras e operações registradas
  • Responsabilidade total, incluindo operações em discordância ou sub judice
  • Data de início do relacionamento
  • Obrigações assumidas e percentuais de processamento

Carteira de Crédito: Resumo consolidado contendo totalizações de limite disponível, prejuízos acumulados, saldos a vencer e vencidos.

Modalidades: Detalhe de cada modalidade de crédito contratada, com informações de:

  • Valores a vencer segmentados por faixas temporais (1-30 dias, 31-60 dias, 61-90 dias, 91-180 dias, 181-360 dias, acima de 361 dias)
  • Valores vencidos nas mesmas faixas
  • Prejuízos por período (12, 24, 36 e 48 meses, além de acima de 48 meses)
  • Limite de crédito e código/descrição da modalidade
  • Indicação de variação cambial
Exemplo — 200 OK
{
  "score": "string",
  "faixaRisco": "string",
  "riscoTotal": null,
  "modalidades": [],
  "mesReferencia": "string",
  "carteiraCredito": {
    "total": null,
    "limite": null,
    "vencer": null,
    "vencido": null,
    "prejuizo": null
  },
  "numeroHistorico": null,
  "scoreObservacao": null,
  "obrigacaoAssumida": "string",
  "obrigacaoResumida": "string",
  "documentoConsultado": "string",
  "quantidadeOperacoes": "number",
  "riscoIndiretoVendor": "string",
  "responsabilidadeTotal": "string",
  "quantidadeInstituicoes": "number",
  "dataInicioRelacionamento": null,
  "percentualVolumeProcessado": "string",
  "quantidadeOperacoesSubjudice": "number",
  "percentualDocumentoProcessado": "string",
  "responsabilidadeTotalSubJudice": "string",
  "quantidadeOperacoesDiscordancia": "number",
  "responsabilidadeTotalDiscordancia": "string"
}

O JSON Schema desta consulta é longo demais para caber aqui. A íntegra está na versão em Markdown desta página e na especificação OpenAPI.

Códigos de erro

CódigoMensagemQuando acontece
400Requisição Inválidaa requisição está incorreta ou os parâmetros são inválidos.
401Não Autenticadoo usuário não forneceu as credenciais corretas para acessar o recurso.
403Não Autorizadoo servidor recebeu a requisição, mas se negou a autorizá-la por conta de saldo indisponível.
404Não Encontradoo servidor não encontrou uma representação atual do recurso solicitado.
408Tempo Esgotadoo servidor não conseguiu retornar a requisição no prazo estabelecido.
500Falha ao Realizar Consultao servidor não conseguiu processar a requisição com sucesso. Por favor, entre em contato com o nosso suporte.
503Consulta em Manutençãoa consulta requisitada está em manutenção. Por favor, entre em contato com o nosso suporte.

Observações

  • Cada requisição deve informar um único documento de identificação por vez
  • Esta consulta não gera comprovantes oficiais
  • Os dados refletem o estado atual das informações no sistema central do BACEN, atualizado mensalmente
  • Em caso de inconsistências ou dúvidas sobre os dados retornados, o cliente pode entrar em contato com o BACEN diretamente

Integrar

OpenAPI (JSON) ↗ — importe a URL no Postman ou no Insomnia para gerar a coleção com todos os endpoints. Também dá para consultar pelo chat: conecte via MCP. Esta página em Markdown.