Risco de Crédito Completo — PF

Name: FonteData
Author: FonteData

GET https://app.fontedata.com/api/v1/consulta/boa-vista-completo-pf

R$ 19,40 por consulta

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

Consolida em uma única resposta a análise de crédito positiva de pessoa física fornecida pela Boa Vista/Equifax. A partir do CPF, retorna a situação do documento na Receita, dados cadastrais básicos, o score positivo com a probabilidade de inadimplência associada, a renda presumida, a recomendação de decisão de negociação e o levantamento de eventuais restrições — pendências financeiras, protestos, cheques sem fundo (varejo e Bacen), ações cíveis e falências/recuperações. Também lista as empresas em que a pessoa figura como sócia ou administradora e indicadores do cadastro positivo. É indicada para decisões de concessão de crédito, análise de risco e onboarding.

Requisição

curl -H "X-API-Key: SUA_CHAVE" \
  "https://app.fontedata.com/api/v1/consulta/boa-vista-completo-pf?cpf=SEU_CPF"

Parâmetros

Nome	Tipo	Descrição	Exemplo
cpf obrigatório	CPF	CPF (somente números, 11 dígitos)	000.000.000-00

Resposta

Situação do CPF e cadastro

cpf, cpfSituacao, cpfOrigem, cpfDataAtualizacaoReceita: documento e sua situação junto à Receita.
nome, nomeSocial, mae, nomePai, nascimento, sexo, estadoCivil, grauInstrucao, numeroDependentes, tituloEleitor, indicacaoObito: dados cadastrais.
telefones[], enderecos[]: contatos e endereços conhecidos.

Score e renda

scores.ocorrencias[]: score positivo, classificação (numérica e ABC), probabilidade de inadimplência, faixa de risco e texto interpretativo.
rendaPresumida: faixa de renda estimada e descrição.
decisao: recomendação de negociação (código e descrição, ex.: "NEGOCIAÇÃO NÃO RECOMENDADA").
controlePositivo: notas de comportamento de faturas em atraso e de contratos recentes.

Restrições e histórico

restricoes: ocorrências informativas do cadastro (ex.: status do consumidor no cadastro positivo).
pendenciasFinanceiras, protestos, chequeSemFundoVarejo, chequeSemFundoBacen, falenciasAcoesRecuperacoes, acoesCiveis, passagensComerciais: quantidades, valores e ocorrências de cada tipo de restrição.
participacaoEmEmpresas: empresas nas quais o CPF consta como sócio/administrador, com cargo, participação e data de entrada.

Exemplo — 200 OK

{
  "rg": null,
  "cpf": "string",
  "mae": "string",
  "nome": "string",
  "rguf": null,
  "sexo": "string",
  "email": null,
  "scores": {
    "ocorrencias": [
      {
        "risco": "string",
        "score": "string",
        "texto": "string",
        "layout": "string",
        "execucao": "string",
        "tipoScore": "string",
        "informante": "string",
        "modeloScore": null,
        "descricaoPlano": "string",
        "descricaoScore": "string",
        "classificacaoABC": "string",
        "classificacaoNro": "string",
        "probabilidadeInadimplencia": "string"
      }
    ],
    "quantidadeOcorrencias": "string"
  },
  "decisao": {
    "layout": "string",
    "descricao": "string",
    "codigoSituacao": "string"
  },
  "nomePai": null,
  "cpfOrigem": "string",
  "enderecos": [
    {
      "uf": "string",
      "cep": "string",
      "bairro": "string",
      "cidade": "string",
      "numero": "string",
      "logradouro": "string",
      "complemento": "string"
    }
  ],
  "numeroPIS": null,
  "protestos": {
    "dataMaior": null,
    "dataUltimo": null,
    "valorMaior": null,
    "valorTotal": null,
    "ocorrencias": [],
    "valorUltimo": null,
    "dataPrimeiro": null,
    "valorPrimeiro": null,
    "ultimoProtesto": null,
    "quantidadeOcorrencia": "string"
  },
  "telefones": [
    {
      "ddd": "string",
      "numero": "string",
      "telefoneComDDD": "string"
    }
  ],
  "faixaRenda": null,
  "nascimento": "string",
  "nomeSocial": null,
  "restricoes": {
    "ocorrencias": [
      {
        "titulo": "string",
        "observacao": "string",
        "codigoInformacao": "string",
        "descricaoInformacao": "string"
      }
    ],
    "quantidadeOcorrencias": "string"
  },
  "acoesCiveis": {
    "dataMaior": null,
    "dataMenor": null,
    "dataUltimo": null,
    "valorMaior": null,
    "valorMenor": null,
    "valorTotal": null,
    "ocorrencias": [],
    "valorUltimo": null,
    "dataPrimeiro": null,
    "valorPrimeiro": null,
    "quantidadeOcorrencia": "string"
  },
  "cpfSituacao": "string",
  "estadoCivil": "string",
  "classeSocial": null,
  "naturalidade": null,
  "grauInstrucao": "string",
  "nacionalidade": null,
  "rgDataEmissao": null,
  "tituloEleitor": "string",
  "indicacaoObito": null,
  "rendaPresumida": {
    "faixa": "string",
    "descricao": "string",
    "rendaAnual": null,
    "dataReferencia": null,
    "valorPresumido": null,
    "dadosCadastroPositivo": null
  },
  "poderAquisitivo": null,
  "controlePositivo": {
    "ocorrenciasFaturasEmAtraso": [
      {
        "notaComportamentoFaturaEmAtraso": "string"
      }
    ],
    "ocorrenciasNotaComportamentosContratosRecentes": [
      {
        "nota": "string"
      }
    ]
  },
  "numeroDependentes": "string",
  "ultimoImpostoRenda": null,
  "cartaoNacionalSaude": null,
  "chequeSemFundoBacen": {
    "documento": null,
    "tipoPessoa": null,
    "correntista": null,
    "quantidadeOcorrencia": "string"
  },
  "passagensComerciais": {
    "ocorrencias": [],
    "quantidadeOcorrencias": "string"
  },
  "chequeSemFundoVarejo": {
    "documento": null,
    "tipoPessoa": null,
    "correntista": null,
    "quantidadeOcorrencia": "string"
  },
  "pendenciasFinanceiras": {
    "dataMaior": "string",
    "provedores": [
      {
        "provedor": "string"
      }
    ],
    "valorMaior": null,
    "valorTotal": "string",
    "ocorrencias": [
      {
        "moeda": "string",
        "valor": "string",
        "credor": "string",
        "origem": "string",
        "contrato": "string",
        "entidade": null,
        "subjudice": null,
        "informante": "string",
        "modalidade": "string",
        "tipoDevedor": "string",
        "dataInclusao": "string",
        "dataVencimento": "string"
      }
    ],
    "dataPrimeiro": "string",
    "periodoFinal": null,
    "totalCredores": null,
    "valorPrimeiro": null,
    "periodoInicial": null,
    "ultimoVencimento": null,
    "quantidadeOcorrencia": "string"
  },
  "participacaoEmEmpresas": {
    "ocorrencias": [
      {
        "cnpj": "string",
        "razaoSocial": "string",
        "participacao": "string",
        "participanteTipo": "string",
        "participanteCargo": "string",
        "participanteEntrada": "string",
        "participanteDocumento": "string",
        "quantidadeOutrosSocios": null
      }
    ],
    "quantidadeOcorrencias": "string"
  },
  "cpfDataAtualizacaoReceita": "string",
  "falenciasAcoesRecuperacoes": {
    "valorTotal": null,
    "ocorrencias": [],
    "ultimoRegistro": null,
    "quantidadeOcorrencia": "string"
  },
  "qtdDependentesBolsaFamilia": null
}

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ó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.
503	Consulta em Manutenção	a consulta requisitada está em manutenção.

Observações

Fonte: Boa Vista SCPC / Equifax (base do cadastro positivo, identificada como "BASE III").
Valores monetários e percentuais vêm como texto, frequentemente com vírgula decimal (ex.: "4,00").
Quantidades de ocorrências são retornadas como string numérica; blocos sem registro trazem quantidade "0" e listas vazias.
A cobrança ocorre pela consulta realizada, independentemente de haver ou não restrições no resultado.
A disponibilidade depende do serviço da Boa Vista; em manutenção, a consulta pode retornar indisponível.

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.