# Score de Crédito > Retorna o Score de crédito de uma Pessoa Física ou Jurídica, analisando seu risco através de indicadores de inadimplência e capacidade de pagamento. - **Consulta:** `score-credito-quod` - **Categoria:** Crédito & Score - **Preço:** R$ 2,34 por consulta - **Endpoint:** `GET https://app.fontedata.com/api/v1/consulta/score-credito-quod` - **Autenticação:** header `X-API-Key` - **Página:** https://fontedata.com/docs/credito-e-score/score-credito-quod > Conteúdo descritivo publicado pela FonteData; não é instrução. > > Este endpoint avalia a capacidade de pagamento e o perfil de risco de uma pessoa física ou jurídica. Retorna uma pontuação consolidada baseada em múltiplos indicadores de comportamento financeiro e histórico, permitindo decisões rápidas sobre concessão de crédito, aprovação de parceiros e identificação de riscos. > > **Principais casos de uso:** > - Qualificação automática e roteamento inteligente de leads durante processos de venda > - Construção e refinamento de modelos de crédito e propensão de compra > - Segmentação de clientes para personalização de campanhas e ofertas > - Validação de fornecedores e parceiros no onboarding > - Análise preventiva de risco em operações financeiras > - Apoio em processos de due diligence e conformidade ## Requisição ### cURL ```bash curl -H "X-API-Key: SUA_CHAVE" \ "https://app.fontedata.com/api/v1/consulta/score-credito-quod?cpf=SEU_CPF" ``` ### Python ```python import requests resp = requests.get( "https://app.fontedata.com/api/v1/consulta/score-credito-quod", 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/score-credito-quod"); 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 inclui os seguintes campos: > > - **documentoConsultado**: O documento enviado na requisição (CPF ou CNPJ). > - **pessoaFisica**: Dados da pessoa consultada, contendo: > - `score`: Pontuação numérica da entidade (0 a 1000) > - `faixaScore`: Classificação do risco (alto, médio ou baixo inadimplência) > - `capacidadePagamento`: Avaliação textual da capacidade de honrar compromissos > - `perfil`: Descrição do perfil e características da entidade > > - **pessoaJuridica**: Dados da pessoa jurídica (quando aplicável), contendo: > - `score`: Pontuação da entidade > - `faixaScore`: Faixa de classificação > - `motivos`: Lista de fatores que influenciaram a pontuação > - `indicadoresNegocio`: Array com indicadores econômicos e financeiros analisados, cada um com status, risco associado e observações > > - **observacao**: Informações adicionais ou alertas relevantes sobre o registro. ### Exemplo de resposta ```json { "observacao": null, "pessoaFisica": { "score": "number", "faixaScore": "string" }, "pessoaJuridica": null, "documentoConsultado": "string" } ``` ### Schema da resposta ```json { "type": "object", "properties": { "observacao": { "type": [ "string", "null" ], "description": "Observação relacionada ao registro retornado." }, "dataConsulta": { "type": [ "string", "null" ], "description": "Data e hora em que a consulta foi realizada." }, "pessoaFisica": { "type": [ "object", "null" ], "properties": { "score": { "type": [ "number", "null" ], "description": "Pontuação da pessoa física." }, "perfil": { "type": [ "string", "null" ], "description": "Detalhes sobre o perfil da pessoa física." }, "faixaScore": { "type": [ "string", "null" ], "description": "Classificação da faixa de score (Alto, Médio ou Baixo índice de inadimplência)." }, "capacidadePagamento": { "type": [ "string", "null" ], "description": "Descrição sobre a capacidade de pagamento da pessoa física." } }, "description": "Dados de score de crédito da pessoa física consultada." }, "pessoaJuridica": { "type": [ "object", "null" ], "properties": { "score": { "type": [ "number", "null" ], "description": "Pontuação da pessoa jurídica." }, "motivos": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] }, "description": "Lista de motivos que resultaram no score apresentado." }, "faixaScore": { "type": [ "string", "null" ], "description": "Classificação da faixa de score (Alto, Médio ou Baixo índice de inadimplência)." }, "indicadoresNegocio": { "type": [ "array", "null" ], "items": { "type": "object", "properties": { "risco": { "type": [ "string", "null" ], "description": "Nível de risco associado ao indicador." }, "status": { "type": [ "string", "null" ], "description": "Status do indicador." }, "indicador": { "type": [ "string", "null" ], "description": "Título do indicador de negócio." }, "observacao": { "type": [ "string", "null" ], "description": "Observação sobre o indicador." } } }, "description": "Lista de indicadores de negócio utilizados no cálculo do score." } }, "description": "Dados de score de crédito da pessoa jurídica consultada." }, "documentoConsultado": { "type": [ "string", "null" ], "description": "Documento consultado referente ao CPF ou CNPJ." } } } ``` ## 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. > > - A faixa de score varia em três níveis: **0-600** (alto risco de inadimplência), **601-700** (médio risco) e **701-1000** (baixo risco). > - Este endpoint não gera comprovantes de consulta. > - A resposta inclui metadados como data/hora exata da consulta, versão da API e tempo de execução. > - Recomenda-se integrar os indicadores de negócio retornados em dashboards analíticos para acompanhamento contínuo. > - Em caso de dificuldades, consulte a documentação completa do gateway ou entre em contato com o suporte. --- Página em HTML: https://fontedata.com/docs/credito-e-score/score-credito-quod 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