Histórico de Crédito - SCR Analítico

GET https://app.fontedata.com/api/v1/consulta/credito-scr-analitico
R$ 5,85 por consulta

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

Consulta detalhadas informações de histórico creditício baseadas no Sistema de Informações de Créditos, um repositório central mantido pelo Banco Central do Brasil. Esta consulta agrega dados sobre operações de crédito com exposição igual ou superior a R$ 200,00, permitindo análise completa do perfil de risco e comportamento de pagamento.

O endpoint fornece uma visão abrangente do perfil creditício da entidade consultada, incluindo classificação de risco, composição da carteira, vencimentos pendentes e evolução do compromisso financeiro. É especialmente útil para:

  • Validação cadastral: Confirmar informações de clientes e fornecedores contra registros oficiais
  • Análise de risco: Avaliar exposição creditícia e probabilidade de inadimplência
  • Conformidade e compliance: Subsidiar decisões regulatórias e de crédito
  • Decisões operacionais: Automatizar fluxos de aprovação e concessão de crédito

Os dados retornados abrangem múltiplas dimensões: indicadores de risco, distribuição de operações por modalidade, períodos de vencimento, relacionamentos bancários e métricas de evolução.

Requisição

curl -H "X-API-Key: SUA_CHAVE" \
  "https://app.fontedata.com/api/v1/consulta/credito-scr-analitico?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 contém os seguintes campos:

Dados gerais: documentoConsultado, situacao, relacionamentos, perfil, quantidadeInstituicoes, quantidadeOperacoes

Indicadores de risco: score, classeRisco, volume

Composição da carteira: indice (consolidado, por cartão, crédito pessoal e cheque especial), carteiraCredito (valores a vencer e vencidos)

Análise temporal: percentualPrazo (distribuição em curto, médio e longo prazo), percentualVencido (cartão, empréstimos, financiamentos nas modalidades imobiliária e veicular, adiantamento de depósitos)

Distribuição por modalidade: percentualCategoria (linha de risco maior, cartão, financiamentos, empréstimos, financiamentos de exportação, imobiliários, veiculares, adiantamentos de depositantes, operações de arrendamento, coobrigações, outros créditos e outras operações)

Evolução financeira: percentualEvolucaoCompromisso (total, maior risco, financiamentos e cartão)

Exemplo — 200 OK
{
  "score": "string",
  "indice": {
    "total": "string",
    "cartao": "string",
    "chequeEspecial": "string",
    "creditoPessoal": "string"
  },
  "perfil": "string",
  "volume": "string",
  "situacao": "string",
  "classeRisco": "string",
  "carteiraCredito": {
    "valorVencer": "string",
    "valorVencida": "string"
  },
  "percentualPrazo": {
    "curto": "string",
    "longo": "string",
    "medio": "string"
  },
  "relacionamentos": "string",
  "percentualVencido": {
    "cartao": "string",
    "emprestimos": "string",
    "financiamentos": "string",
    "adiantamentoDepositos": "string",
    "financiamentosVeiculos": "string",
    "financiamentosImobiliarios": "string"
  },
  "documentoConsultado": "string",
  "percentualCategoria": {
    "cartao": "string",
    "outros": "string",
    "emprestimos": "string",
    "coobrigacoes": "string",
    "financiamentos": "string",
    "outrosCreditos": "string",
    "linhaRiscoMaior": "string",
    "operacoesArrendamento": "string",
    "financiamentosVeiculos": "string",
    "financiamentosExportacao": "string",
    "adiantamentosDepositantes": "string",
    "financiamentosImobiliarios": "string"
  },
  "quantidadeOperacoes": "number",
  "quantidadeInstituicoes": "number",
  "percentualEvolucaoCompromisso": {
    "total": "string",
    "cartao": "string",
    "maiorRisco": "string",
    "financiamentos": "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 processa apenas um documento por vez
  • A consulta retorna dados consolidados conforme reportado pelas instituições financeiras ao Sistema de Informações de Créditos
  • Informações refletem posição em data específica e são atualizadas conforme alimentação das instituições financeiras
  • O sigilo bancário é respeitado em conformidade com regulamentações do Banco Central
  • Recomenda-se usar esta consulta como complemento a outras ferramentas de análise de crédito e risco
  • Valores monetários podem estar em diferentes formatos; consulte a API para tipagem exata

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.