# Histórico de Crédito - SCR

> Consulta o histórico de crédito de pessoas e empresas no SCR do BACEN, retornando dados sobre operações, inadimplências, faixas de risco e modalidades de crédito.

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

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

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

### Python

```python
import requests

resp = requests.get(
    "https://app.fontedata.com/api/v1/consulta/credito-scr-resumo",
    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-resumo");

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 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 de resposta

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

### Schema da resposta

```json
{
  "type": "object",
  "properties": {
    "score": {
      "type": [
        "string",
        "null"
      ],
      "description": "Pontuação da entidade consultada."
    },
    "faixaRisco": {
      "type": [
        "string",
        "null"
      ],
      "description": "Faixa de risco de crédito."
    },
    "riscoTotal": {
      "type": [
        "string",
        "null"
      ],
      "description": "Valor do risco total."
    },
    "modalidades": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "properties": {
          "aVencer": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "total": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Total a vencer."
              },
              "de1a30Dias": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Valor de 1 a 30 dias."
              },
              "de31a60Dias": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Valor de 31 a 60 dias."
              },
              "de61a90Dias": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Valor de 61 a 90 dias."
              },
              "de91a180Dias": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Valor de 91 a 180 dias."
              },
              "de181a360Dias": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Valor de 181 a 360 dias."
              },
              "acimaDe361Dias": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Valor acima de 361 dias."
              }
            },
            "description": "Detalhes dos valores a vencer."
          },
          "vencido": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "total": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Total vencido."
              },
              "de1a30Dias": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Vencido de 1 a 30 dias."
              },
              "de31a60Dias": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Vencido de 31 a 60 dias."
              },
              "de61a90Dias": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Vencido de 61 a 90 dias."
              },
              "de91a180Dias": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Vencido de 91 a 180 dias."
              },
              "de181a360Dias": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Vencido de 181 a 360 dias."
              },
              "acimaDe361Dias": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Vencido acima de 361 dias."
              }
            },
            "description": "Detalhes dos valores vencidos."
          },
          "prejuizo": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "total": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Total de prejuízo."
              },
              "acimaDe48Meses": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Prejuízo acima de 48 meses."
              },
              "prejuizo12Meses": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Prejuízo em 12 meses."
              },
              "prejuizo24Meses": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Prejuízo em 24 meses."
              },
              "prejuizo36Meses": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Prejuízo em 36 meses."
              },
              "prejuizo48Meses": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Prejuízo em 48 meses."
              }
            },
            "description": "Detalhes dos valores de prejuízo."
          },
          "limiteCredito": {
            "type": [
              "string",
              "null"
            ],
            "description": "Limite de crédito da modalidade."
          },
          "variacaoCambial": {
            "type": [
              "string",
              "null"
            ],
            "description": "Indicador de variação cambial."
          },
          "codigoModalidade": {
            "type": [
              "string",
              "null"
            ],
            "description": "Código da modalidade."
          },
          "descricaoModalidade": {
            "type": [
              "string",
              "null"
            ],
            "description": "Descrição da modalidade."
          }
        }
      },
      "description": "Lista de modalidades de crédito."
    },
    "carteiraCredito": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "total": {
          "type": [
            "string",
            "null"
          ],
          "description": "Total da carteira."
        },
        "limite": {
          "type": [
            "string",
            "null"
          ],
          "description": "Limite da carteira."
        },
        "vencer": {
          "type": [
            "string",
            "null"
          ],
          "description": "Valor a vencer na carteira."
        },
        "vencido": {
          "type": [
            "string",
            "null"
          ],
          "description": "Valor vencido na carteira."
        },
        "prejuizo": {
          "type": [
            "string",
            "null"
          ],
          "description": "Valor de prejuízo na carteira."
        }
      },
      "description": "Informações da carteira de crédito."
    },
    "numeroHistorico": {
      "type": [
        "number",
        "null"
      ],
      "description": "Número de histórico do registro."
    },
    "scoreObservacao": {
      "type": [
        "string",
        "null"
      ],
      "description": "Observação referente ao score."
    },
    "obrigacaoAssumida": {
      "type": [
        "string",
        "null"
      ],
      "description": "Valor de obrigação assumida."
    },
    "obrigacaoResumida": {
      "type": [
        "string",
        "null"
      ],
      "description": "Valor resumido de obrigação."
    },
    "documentoConsultado": {
      "type": [
        "string",
        "null"
      ],
      "description": "Documento consultado (CPF ou CNPJ)."
    },
    "quantidadeOperacoes": {
      "type": [
        "number",
        "null"
      ],
      "description": "Quantidade total de operações."
    },
    "riscoIndiretoVendor": {
      "type": [
        "string",
        "null"
      ],
      "description": "Valor de risco indireto."
    },
    "responsabilidadeTotal": {
      "type": [
        "string",
        "null"
      ],
      "description": "Valor de responsabilidade total."
    },
    "quantidadeInstituicoes": {
      "type": [
        "number",
        "null"
      ],
      "description": "Quantidade de instituições."
    },
    "dataInicioRelacionamento": {
      "type": [
        "string",
        "null"
      ],
      "description": "Data de início do relacionamento."
    },
    "percentualVolumeProcessado": {
      "type": [
        "string",
        "null"
      ],
      "description": "Percentual de volume processado."
    },
    "quantidadeOperacoesSubjudice": {
      "type": [
        "number",
        "null"
      ],
      "description": "Quantidade de operações sub judice."
    },
    "percentualDocumentoProcessado": {
      "type": [
        "string",
        "null"
      ],
      "description": "Percentual de documento processado."
    },
    "responsabilidadeTotalSubJudice": {
      "type": [
        "string",
        "null"
      ],
      "description": "Valor de responsabilidade total sub judice."
    },
    "quantidadeOperacoesDiscordancia": {
      "type": [
        "number",
        "null"
      ],
      "description": "Quantidade de operações em discordância."
    },
    "responsabilidadeTotalDiscordancia": {
      "type": [
        "string",
        "null"
      ],
      "description": "Valor de responsabilidade total em discordância."
    }
  }
}
```

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

---

Página em HTML: https://fontedata.com/docs/credito-e-score/credito-scr-resumo
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