# Risco de Crédito Completo — PF

> Relatório completo de análise de crédito de pessoa física da Boa Vista/Equifax a partir do CPF, reunindo situação cadastral do CPF, score positivo, renda presumida, recomendação de negociação e o histórico de restrições (pendências financeiras, protestos, cheques sem fundo, ações cíveis, falências) e de participação societária.

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

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

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

### Python

```python
import requests

resp = requests.get(
    "https://app.fontedata.com/api/v1/consulta/boa-vista-completo-pf",
    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/boa-vista-completo-pf");

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

| Nome | Tipo | Obrigatório | Descrição | Exemplo |
|---|---|---|---|---|
| `cpf` | CPF | sim | CPF (somente números, 11 dígitos) | formato: 000.000.000-00 |

## Resposta

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

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

### Schema da resposta

```json
{
  "type": "object",
  "properties": {
    "rg": {
      "type": [
        "string",
        "null"
      ],
      "description": "Número do RG, quando disponível."
    },
    "cpf": {
      "type": [
        "string",
        "null"
      ],
      "description": "CPF pesquisado."
    },
    "mae": {
      "type": [
        "string",
        "null"
      ],
      "description": "Nome da mãe."
    },
    "nome": {
      "type": [
        "string",
        "null"
      ],
      "description": "Nome completo."
    },
    "rguf": {
      "type": [
        "string",
        "null"
      ],
      "description": "UF emissora do RG."
    },
    "sexo": {
      "type": [
        "string",
        "null"
      ],
      "description": "Sexo."
    },
    "email": {
      "type": [
        "string",
        "null"
      ],
      "description": "E-mail associado."
    },
    "scores": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "ocorrencias": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": "object",
            "properties": {
              "risco": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Faixa de risco (ex.: NULO, BAIXO)."
              },
              "score": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Valor do score."
              },
              "texto": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Texto interpretativo do score."
              },
              "layout": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Layout/modelo do score."
              },
              "execucao": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Indicador de execução."
              },
              "tipoScore": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Tipo do score."
              },
              "informante": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Base informante."
              },
              "modeloScore": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Modelo de score."
              },
              "descricaoPlano": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Descrição do plano."
              },
              "descricaoScore": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Descrição do score."
              },
              "classificacaoABC": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Classificação em letras (A/B/C...)."
              },
              "classificacaoNro": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Classificação numérica."
              },
              "probabilidadeInadimplencia": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Probabilidade de inadimplência (%)."
              }
            }
          },
          "description": "Ocorrências de score positivo."
        },
        "quantidadeOcorrencias": {
          "type": [
            "string",
            "null"
          ],
          "description": "Quantidade de scores retornados."
        }
      },
      "description": "Score positivo de crédito."
    },
    "decisao": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "layout": {
          "type": [
            "string",
            "null"
          ],
          "description": "Layout da decisão."
        },
        "descricao": {
          "type": [
            "string",
            "null"
          ],
          "description": "Descrição da recomendação (ex.: NEGOCIACAO NAO RECOMENDADA)."
        },
        "codigoSituacao": {
          "type": [
            "string",
            "null"
          ],
          "description": "Código da situação de decisão."
        }
      },
      "description": "Recomendação de decisão de negociação."
    },
    "nomePai": {
      "type": [
        "string",
        "null"
      ],
      "description": "Nome do pai."
    },
    "cpfOrigem": {
      "type": [
        "string",
        "null"
      ],
      "description": "UF de origem do CPF."
    },
    "enderecos": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "properties": {
          "uf": {
            "type": [
              "string",
              "null"
            ],
            "description": "UF."
          },
          "cep": {
            "type": [
              "string",
              "null"
            ],
            "description": "CEP."
          },
          "bairro": {
            "type": [
              "string",
              "null"
            ],
            "description": "Bairro."
          },
          "cidade": {
            "type": [
              "string",
              "null"
            ],
            "description": "Cidade."
          },
          "numero": {
            "type": [
              "string",
              "null"
            ],
            "description": "Número."
          },
          "logradouro": {
            "type": [
              "string",
              "null"
            ],
            "description": "Logradouro."
          },
          "complemento": {
            "type": [
              "string",
              "null"
            ],
            "description": "Complemento."
          }
        }
      },
      "description": "Endereços conhecidos."
    },
    "numeroPIS": {
      "type": [
        "string",
        "null"
      ],
      "description": "Número do PIS."
    },
    "protestos": {
      "type": [
        "object",
        "null"
      ],
      "description": "Protestos: quantidade, valores, datas e ocorrências."
    },
    "telefones": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "properties": {
          "ddd": {
            "type": [
              "string",
              "null"
            ],
            "description": "DDD do telefone."
          },
          "numero": {
            "type": [
              "string",
              "null"
            ],
            "description": "Número do telefone."
          },
          "telefoneComDDD": {
            "type": [
              "string",
              "null"
            ],
            "description": "Telefone formatado com DDD."
          }
        }
      },
      "description": "Telefones conhecidos."
    },
    "faixaRenda": {
      "type": [
        "string",
        "null"
      ],
      "description": "Faixa de renda cadastral."
    },
    "nascimento": {
      "type": [
        "string",
        "null"
      ],
      "description": "Data de nascimento."
    },
    "nomeSocial": {
      "type": [
        "string",
        "null"
      ],
      "description": "Nome social, quando houver."
    },
    "restricoes": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "ocorrencias": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": "object",
            "properties": {
              "titulo": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Título da ocorrência."
              },
              "observacao": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Observação/detalhe da ocorrência."
              },
              "codigoInformacao": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Código da informação."
              },
              "descricaoInformacao": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Descrição do tipo de informação."
              }
            }
          },
          "description": "Lista de ocorrências informativas do cadastro."
        },
        "quantidadeOcorrencias": {
          "type": [
            "string",
            "null"
          ],
          "description": "Quantidade de ocorrências informativas."
        }
      },
      "description": "Ocorrências informativas associadas ao CPF."
    },
    "acoesCiveis": {
      "type": [
        "object",
        "null"
      ],
      "description": "Ações cíveis: quantidade, valores, datas e ocorrências."
    },
    "cpfSituacao": {
      "type": [
        "string",
        "null"
      ],
      "description": "Situação cadastral do CPF na Receita (ex.: REGULAR)."
    },
    "estadoCivil": {
      "type": [
        "string",
        "null"
      ],
      "description": "Estado civil."
    },
    "classeSocial": {
      "type": [
        "string",
        "null"
      ],
      "description": "Classe social estimada."
    },
    "naturalidade": {
      "type": [
        "string",
        "null"
      ],
      "description": "Naturalidade."
    },
    "grauInstrucao": {
      "type": [
        "string",
        "null"
      ],
      "description": "Grau de instrução."
    },
    "nacionalidade": {
      "type": [
        "string",
        "null"
      ],
      "description": "Nacionalidade."
    },
    "rgDataEmissao": {
      "type": [
        "string",
        "null"
      ],
      "description": "Data de emissão do RG."
    },
    "tituloEleitor": {
      "type": [
        "string",
        "null"
      ],
      "description": "Número do título de eleitor."
    },
    "indicacaoObito": {
      "type": [
        "string",
        "null"
      ],
      "description": "Indicação de óbito, quando houver."
    },
    "rendaPresumida": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "faixa": {
          "type": [
            "string",
            "null"
          ],
          "description": "Faixa de renda estimada."
        },
        "descricao": {
          "type": [
            "string",
            "null"
          ],
          "description": "Descrição da renda presumida."
        },
        "rendaAnual": {
          "type": [
            "string",
            "null"
          ],
          "description": "Renda anual estimada."
        },
        "dataReferencia": {
          "type": [
            "string",
            "null"
          ],
          "description": "Data de referência."
        },
        "valorPresumido": {
          "type": [
            "string",
            "null"
          ],
          "description": "Valor presumido."
        },
        "dadosCadastroPositivo": {
          "type": [
            "string",
            "null"
          ],
          "description": "Dados do cadastro positivo."
        }
      },
      "description": "Renda presumida da pessoa física."
    },
    "poderAquisitivo": {
      "type": [
        "string",
        "null"
      ],
      "description": "Poder aquisitivo estimado."
    },
    "controlePositivo": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "ocorrenciasFaturasEmAtraso": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": "object",
            "properties": {
              "notaComportamentoFaturaEmAtraso": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Nota de comportamento de faturas em atraso."
              }
            }
          },
          "description": "Notas de comportamento de faturas em atraso."
        },
        "ocorrenciasNotaComportamentosContratosRecentes": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": "object",
            "properties": {
              "nota": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Nota de comportamento de contratos recentes."
              }
            }
          },
          "description": "Notas de comportamento de contratos recentes."
        }
      },
      "description": "Indicadores do cadastro positivo (comportamento de pagamento)."
    },
    "numeroDependentes": {
      "type": [
        "string",
        "null"
      ],
      "description": "Quantidade de dependentes."
    },
    "ultimoImpostoRenda": {
      "type": [
        "string",
        "null"
      ],
      "description": "Situação do último imposto de renda."
    },
    "cartaoNacionalSaude": {
      "type": [
        "string",
        "null"
      ],
      "description": "Número do Cartão Nacional de Saúde."
    },
    "chequeSemFundoBacen": {
      "type": [
        "object",
        "null"
      ],
      "description": "Cheques sem fundo registrados no Bacen."
    },
    "passagensComerciais": {
      "type": [
        "object",
        "null"
      ],
      "description": "Consultas/passagens comerciais recentes."
    },
    "chequeSemFundoVarejo": {
      "type": [
        "object",
        "null"
      ],
      "description": "Cheques sem fundo registrados no varejo."
    },
    "pendenciasFinanceiras": {
      "type": [
        "object",
        "null"
      ],
      "description": "Pendências financeiras: quantidade, valores, período, credores e ocorrências."
    },
    "participacaoEmEmpresas": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "ocorrencias": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": "object",
            "properties": {
              "cnpj": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "CNPJ da empresa."
              },
              "razaoSocial": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Razão social da empresa."
              },
              "participacao": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Percentual de participação."
              },
              "participanteTipo": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Tipo de participante (FISICA/JURIDICA)."
              },
              "participanteCargo": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Cargo exercido."
              },
              "participanteEntrada": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Data de entrada na sociedade."
              },
              "participanteDocumento": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Documento do participante."
              },
              "quantidadeOutrosSocios": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Quantidade de outros sócios."
              }
            }
          },
          "description": "Empresas em que o CPF consta como sócio/administrador."
        },
        "quantidadeOcorrencias": {
          "type": [
            "string",
            "null"
          ],
          "description": "Quantidade de participações societárias."
        }
      },
      "description": "Participações societárias do CPF."
    },
    "cpfDataAtualizacaoReceita": {
      "type": [
        "string",
        "null"
      ],
      "description": "Data da última atualização do CPF na Receita."
    },
    "falenciasAcoesRecuperacoes": {
      "type": [
        "object",
        "null"
      ],
      "description": "Falências, ações e recuperações judiciais."
    },
    "qtdDependentesBolsaFamilia": {
      "type": [
        "string",
        "null"
      ],
      "description": "Quantidade de dependentes no Bolsa Família."
    }
  }
}
```

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

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

---

Página em HTML: https://fontedata.com/docs/credito-e-score/boa-vista-completo-pf
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