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

> Fornece análise completa do histórico de crédito e risco no SCR do Banco Central, incluindo carteira de crédito, classe de risco, operações e situação financeira da entidade.

- **Consulta:** `credito-scr-analitico`
- **Categoria:** Crédito & Score
- **Preço:** R$ 5,85 por consulta
- **Endpoint:** `GET https://app.fontedata.com/api/v1/consulta/credito-scr-analitico`
- **Autenticação:** header `X-API-Key`
- **Página:** https://fontedata.com/docs/credito-e-score/credito-scr-analitico

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> 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

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

### Python

```python
import requests

resp = requests.get(
    "https://app.fontedata.com/api/v1/consulta/credito-scr-analitico",
    params={"cpf": "SEU_CPF"},
    headers={"X-API-Key": "SUA_CHAVE"},
    timeout=60,
)
resp.raise_for_status()
print(resp.json())
```

### Node.js

```javascript
const url = new URL("https://app.fontedata.com/api/v1/consulta/credito-scr-analitico");

url.search = new URLSearchParams({
  "cpf": "SEU_CPF"
}).toString();

const resp = await fetch(url, {
  method: "GET",
  headers: { "X-API-Key": "SUA_CHAVE" }
});

if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
console.log(await resp.json());
```

## Parâmetros

Informe `cpf` ou `cnpj`.

| Nome | Tipo | Obrigatório | Descrição | Exemplo |
|---|---|---|---|---|
| `cpf` | CPF | condicional | CPF (somente números, 11 dígitos) | formato: 000.000.000-00 |
| `cnpj` | CNPJ | condicional | CNPJ (somente números, 14 dígitos) | formato: 00.000.000/0000-00 |

## Resposta

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> 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 de resposta

```json
{
  "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"
  }
}
```

### Schema da resposta

```json
{
  "type": "object",
  "properties": {
    "score": {
      "type": [
        "string",
        "null"
      ],
      "description": "Pontuação ou score de crédito da entidade consultada."
    },
    "indice": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "total": {
          "type": [
            "string",
            "null"
          ],
          "description": "Valor total do índice de crédito."
        },
        "cartao": {
          "type": [
            "string",
            "null"
          ],
          "description": "Índice de crédito referente a cartões."
        },
        "chequeEspecial": {
          "type": [
            "string",
            "null"
          ],
          "description": "Índice de crédito referente a cheque especial."
        },
        "creditoPessoal": {
          "type": [
            "string",
            "null"
          ],
          "description": "Índice de crédito referente a crédito pessoal."
        }
      },
      "description": "Índices de crédito segregados por modalidade."
    },
    "perfil": {
      "type": [
        "string",
        "null"
      ],
      "description": "Perfil de crédito da entidade consultada."
    },
    "volume": {
      "type": [
        "string",
        "null"
      ],
      "description": "Volume de crédito da entidade."
    },
    "situacao": {
      "type": [
        "string",
        "null"
      ],
      "description": "Situação atual do registro da entidade."
    },
    "classeRisco": {
      "type": [
        "string",
        "null"
      ],
      "description": "Classe de risco de crédito atribuída à entidade."
    },
    "carteiraCredito": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "valorVencer": {
          "type": [
            "string",
            "null"
          ],
          "description": "Valor de crédito a vencer."
        },
        "valorVencida": {
          "type": [
            "string",
            "null"
          ],
          "description": "Valor de crédito vencido."
        }
      },
      "description": "Detalhes da carteira de crédito da entidade."
    },
    "percentualPrazo": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "curto": {
          "type": [
            "string",
            "null"
          ],
          "description": "Percentual de crédito no curto prazo."
        },
        "longo": {
          "type": [
            "string",
            "null"
          ],
          "description": "Percentual de crédito no longo prazo."
        },
        "medio": {
          "type": [
            "string",
            "null"
          ],
          "description": "Percentual de crédito no médio prazo."
        }
      },
      "description": "Distribuição percentual do crédito por prazo."
    },
    "relacionamentos": {
      "type": [
        "string",
        "null"
      ],
      "description": "Grau ou quantidade de relacionamentos creditícios."
    },
    "percentualVencido": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "cartao": {
          "type": [
            "string",
            "null"
          ],
          "description": "Percentual vencido em cartões."
        },
        "emprestimos": {
          "type": [
            "string",
            "null"
          ],
          "description": "Percentual vencido em empréstimos."
        },
        "financiamentos": {
          "type": [
            "string",
            "null"
          ],
          "description": "Percentual vencido em financiamentos."
        },
        "adiantamentoDepositos": {
          "type": [
            "string",
            "null"
          ],
          "description": "Percentual vencido em adiantamento de depósitos."
        },
        "financiamentosVeiculos": {
          "type": [
            "string",
            "null"
          ],
          "description": "Percentual vencido em financiamentos de veículos."
        },
        "financiamentosImobiliarios": {
          "type": [
            "string",
            "null"
          ],
          "description": "Percentual vencido em financiamentos imobiliários."
        }
      },
      "description": "Distribuição percentual de operações vencidas por tipo."
    },
    "documentoConsultado": {
      "type": [
        "string",
        "null"
      ],
      "description": "Documento (CPF ou CNPJ) consultado."
    },
    "percentualCategoria": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "cartao": {
          "type": [
            "string",
            "null"
          ],
          "description": "Percentual de cartões."
        },
        "outros": {
          "type": [
            "string",
            "null"
          ],
          "description": "Percentual de outras operações."
        },
        "emprestimos": {
          "type": [
            "string",
            "null"
          ],
          "description": "Percentual de empréstimos."
        },
        "coobrigacoes": {
          "type": [
            "string",
            "null"
          ],
          "description": "Percentual de coobrigações."
        },
        "financiamentos": {
          "type": [
            "string",
            "null"
          ],
          "description": "Percentual de financiamentos."
        },
        "outrosCreditos": {
          "type": [
            "string",
            "null"
          ],
          "description": "Percentual de outros créditos."
        },
        "linhaRiscoMaior": {
          "type": [
            "string",
            "null"
          ],
          "description": "Percentual de operações de linha de risco maior."
        },
        "operacoesArrendamento": {
          "type": [
            "string",
            "null"
          ],
          "description": "Percentual de operações de arrendamento."
        },
        "financiamentosVeiculos": {
          "type": [
            "string",
            "null"
          ],
          "description": "Percentual de financiamentos de veículos."
        },
        "financiamentosExportacao": {
          "type": [
            "string",
            "null"
          ],
          "description": "Percentual de financiamentos de exportação."
        },
        "adiantamentosDepositantes": {
          "type": [
            "string",
            "null"
          ],
          "description": "Percentual de adiantamentos a depositantes."
        },
        "financiamentosImobiliarios": {
          "type": [
            "string",
            "null"
          ],
          "description": "Percentual de financiamentos imobiliários."
        }
      },
      "description": "Distribuição percentual do crédito por categoria de operação."
    },
    "quantidadeOperacoes": {
      "type": [
        "number",
        "null"
      ],
      "description": "Quantidade total de operações de crédito."
    },
    "quantidadeInstituicoes": {
      "type": [
        "number",
        "null"
      ],
      "description": "Quantidade de instituições financeiras envolvidas."
    },
    "percentualEvolucaoCompromisso": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "total": {
          "type": [
            "string",
            "null"
          ],
          "description": "Percentual total de evolução do compromisso."
        },
        "cartao": {
          "type": [
            "string",
            "null"
          ],
          "description": "Percentual de evolução em cartões."
        },
        "maiorRisco": {
          "type": [
            "string",
            "null"
          ],
          "description": "Percentual de evolução em operações de maior risco."
        },
        "financiamentos": {
          "type": [
            "string",
            "null"
          ],
          "description": "Percentual de evolução em financiamentos."
        }
      },
      "description": "Distribuição percentual de evolução do compromisso."
    }
  }
}
```

## Códigos de erro

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

## Observações

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> - 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

---

Página em HTML: https://fontedata.com/docs/credito-e-score/credito-scr-analitico
Catálogo completo: https://fontedata.com/docs
OpenAPI (JSON): https://app.fontedata.com/api/v1/openapi.json
Conectar via MCP: https://fontedata.com/docs/mcp