O endpoint /api/BoaVistaAcertaCompletoPositivoPF permite consultar o relatório completo da Boa Vista para Pessoa Física (CPF), retornando de forma estruturada todas as informações disponíveis no relatório oficial.
Boa Vista - Acerta Completo Positivo Pessoa Física
API responsável por realizar a consulta Boa Vista Acerta Completo Positivo Pessoa Física, retornando de forma estruturada todas as informações disponíveis no relatório oficial em PDF. A API consolida dados cadastrais do CPF, situação na Receita Federal, score de crédito, comportamento de consumo, renda presumida, participação no Cadastro Positivo, além de registros de restrições como protestos, ações cíveis, falências/recuperações judiciais, cheques sem fundos e participação em empresas. Também inclui indicadores de decisão e nível de cautela para negociação, auxiliando análises de crédito, risco e compliance.
Casos de Uso
- Onboarding de clientes pessoa física.
- Análise de risco e crédito.
- Concessão de crédito e financiamento.
- Prevenção à fraude e validação cadastral.
- Processos de due diligence e compliance.
- Avaliação de capacidade financeira e comportamento de pagamento.
Aplicações
- Onboarding de Clientes e Fornecedores
- Análise de Risco/Crédito
Benefícios
- Acesso estruturado ao relatório oficial Boa Vista (versão completa).
- Consolidação de dados cadastrais, restritivos e comportamentais em uma única API.
- Integração simples com sistemas de crédito, antifraude e cadastro.
- Possibilidade de geração de comprovante oficial em PDF.
- Suporte a análises automatizadas de score e probabilidade de inadimplência.
URL Base
A API está hospedada no seguinte endereço:
https://apiv3.directd.com.br/api/BoaVistaAcertaCompletoPositivoPFEndpoint
GET https://apiv3.directd.com.br/api/BoaVistaAcertaCompletoPositivoPF?CPF={0}&Token=Seu_TokenDescrição: Endpoint para realizar consultas Boa Vista - Acerta Completo Positivo Pessoa Física.
Nota: Esta consulta gera comprovantes em PDF.
Esta API suporta geração de comprovantes em PDF
Campos Retornados
- Ação: Informa sobre a ação.
- Ações Cíveis: Detalha sobre ações cíveis.
- Anuência: Informa a anuência do registro.
- Autor: Informa o autor do registro.
- Bairro: Bairro do endereço
- Cargo do Participante: Informa o cargo do participante.
- Cartão Nacional de Saúde: Informa o cartão nacional de saúde do indivíduo.
- Cartório: Informa o cartório do registro.
- CEP: Número CEP do endereço
- Cheque Sem Fundo BACEN: Detalhes sobre cheque sem fundo do BACEN
- Cheque Sem Fundo Varejo: Detalhes sobre cheque sem fundo do varejo
- Cidade: Cidade do registro em questão
- Classe Social: Classe social do indivíduo
- Classificação ABC: Informa a classificação ABC da empresa.
- Cliente da Consulta: Informa o cliente que realizou a consulta.
- CNPJ: CNPJ da empresa
- Código da Informação: Informa o código da informação.
- Código da Situação: Informa o código da situação.
- Comarca: Comarco de origem do processo
- Complemento: Complemento do endereço do registro em questão
- Contrato: Informa qual o contrato do registro.
- Controle Positivo: Detalhes sobre o controle positivo.
- Correntista: Informa o correntista do registro.
- CPF: CPF do indivíduo
- CPF Data de Atualização da Receita: Informa a data de atualização da situação do CPF perante a Receita Federal.
- CPF Origem: Informa o estado de origem do CPF
- CPF Situação: Informa a situação do CPF.
- Credor: Informa o credor do registro.
- Dados de Cadastro Positivo: Informa dados de cadastro positivo.
- Data: Data do registro
- Data da Consulta: Data da consulta
- Data de Distribuição: Data em que o processo foi distribuído.
- Data de Inclusão: Data de inclusão do registro
- Data de Referência: Data de referência do crédito rotativo
- Data de Vencimento: Data de vencimento do registro
- Data do Primeiro: Informa a data do primeiro registro.
- Data do Último: Informa a data do último registro.
- Data Maior: Informa a data do maior registro encontrado.
- Data Menor: Informa a data com a menor ocorrência.
- DDD: Retorna apenas o DDD do número de telefone.
- Decisão: Decisão do julgamento
- Descrição: Descrição do registro
- Descrição da Informação: Informa a descrição da informação.
- Descrição do Plano: Descrição do plano.
- Descrição do Score: Informa a descrição do score.
- Documento: Documento referente ao CPF/CNPJ
- Documento do Participante: Informa o documento do participante.
- E-mail: Endereço de e-mail da entidade
- Endereço do Cliente: Informa o endereço do cliente.
- Entidade: Nome da entidade
- Entrada do Participante: Informa a data de entrada do participante na empresa.
- Estado Civil: Informa o estado civil do indivíduo consultado.
- Execução: Informa a execução do registro.
- Faixa: Faixa do indicador de negócio
- Faixa da Renda: Informa a faixa da renda do indivíduo.
- Falências, Ações e Recuperações: Detalhes sobre falências, Ações e recuperações do indivíduo.
- Foro: Nome do foro responsável
- Grau de Instrução: Informa o grau de instrução do indivíduo.
- Hora da Consulta: Informa a hora da consulta.
- Indicação de Óbito: Indica se o indivíduo possui óbito.
- Informante: Informa de onde veio a informação.
- Layout: Informa o layout do registro.
- Lista de Endereço: Lista os endereços do indivíduo
- Lista de Ocorrências: Lista as ocorrências que o indivíduo possui
- Lista de Ocorrências de Faturas em Atraso: Lista as ocorrências de faturas em atraso.
- Lista de Ocorrências de Nota de Comportamento de Contratos Recentes: Lista as notas de comportamento de contratos recentes.
- Lista de Protestos: Retorna a lista de protestos que o indivíduo possui
- Lista de Provedores: Lista os provedores da informação.
- Lista de Telefones: Telefones vinculados ao indivíduo
- Logradouro: Nome da rua, avenida, travessa, alameda ou outros onde está localizado o endereço.
- Mãe: Informa o nome da mãe.
- Mensagem: Informa uma mensagem a respeito do registro.
- Modalidade: Informa a modalidade do registro.
- Modelo do Score: Informa o modelo do score.
- Moeda: Informa a moeda do registro.
- Nacionalidade: Informa a nacionalidade do indivíduo.
- Nascimento: Informa a data de nascimento do registro
- Naturalidade: Informa a naturalidade do indivíduo.
- Nome: Nome do indivíduo/registro
- Nome do Pai: Nome do pai do indivíduo
- Nome Social: Nome social do indivíduo
- Nota: Informa a nota do registro.
- Nota de Comportamento de Fatura em Atraso: Informa a nota de comportamento de fatura em atraso.
- Número: Número do registro em questão
- Número da Classificação: Informa o número da classificação.
- Número de Dependentes: Informa o número de dependentes do indivíduo.
- Número PIS: Informa o número PIS do indivíduo.
- Observação: Observação relacionada ao registro retornado
- Origem: Origem do processo
- Participação: Descrição da participação no julgamento
- Participação Em Empresas: Detalha as participações em empresas do indivíduo.
- Passagens Comerciais: Detalhes sobre passagens comerciais do indivíduo.
- Pendências Financeiras: Retorna os dados relacionados à pendência financeira.
- Período Final: Informa o período final do registro.
- Período Inicial: Período de início do registro.
- Poder Aquisitivo: Informação sobre o poder aquisitivo do indivíduo.
- Probabilidade de Inadimplência: Informa a probabilidade de inadimplência da entidade.
- Processo: Detalhe sobre o processo
- Provedor: Informa o provedor do registro.
- Quantidade: Quantidade de registros
- Quantidade de Dependentes do Bolsa Família: Informa a quantidade de dependentes do bolsa família.
- Quantidade de Ocorrência: Número de ocorrências
- Quantidade de Ocorrências: Informa a quantidade de ocorrências.
- Quantidade de Outros Sócios: Informa a quantidade de outros sócios na empresa.
- Razão Social: Razão social da empresa
- Renda Anual: Informa a renda anual do indivíduo.
- Renda Presumida: Renda presumida do indivíduo
- Requerido: Informa o requerido do registro.
- Restrições: Detalhes sobre as restrições as quais a entidade ou agente possui.
- Resultado: Informa o resultado.
- RG: Informa o número de RG do titular.
- RG Data de Emissão: Informa a data de emissão do RG.
- RG UF: Informa a UF de origem do RG.
- Risco: Descreve o risco que a entidade possui com relação ao indicador analisado
- Score: Pontuação da entidade consultada
- Scores: Detalhes sobre scores do indivíduo.
- Sexo: Gênero do indivíduo
- Sub Judice: Informa sobre o sub judice do registro.
- Telefone com DDD: Número de telefone incluindo DDD
- Telefone do Cliente: Informa o telefone do cliente.
- Texto da Publicação: Texto de publicação da sanção
- Tipo: Tipo do registro em questão
- Tipo de Anotação: Informa o tipo de anotação.
- Tipo de Participante: Informa o tipo do participante na empresa.
- Tipo de Pessoa: Tipo de pessoa do indivíduo consultado
- Tipo do Devedor: Informa que tipo de devedor é o indivíduo consultado
- Tipo do Score: Informa o tipo de score.
- Título: Título da certidão
- Título de Eleitor: Título de eleitor do indivíduo
- Total de Credores: Informa o total de credores.
- UF: Unidade Federativa (estado) referente ao registro
- Último Imposto de Renda: Informa sobre o último imposto de renda do indivíduo.
- Último Protesto: Informa o último protestos.
- Último Registro: Informa o último registro.
- Último Vencimento: Informa o último vencimento que a entidade possui.
- Valor: Valor da parcela
- Valor das Custas: Informa o valor das custas do registro.
- Valor do Último: Informa o valor do último registro.
- Valor Maior: Informa o maior valor.
- Valor Menor: Informa o menor valor do registro.
- Valor Presumido: Informa a renda presumida da empresa.
- Valor Primeiro: Informa o valor do primeiro registro.
- Valor Total: Valor total do registro
- Vara: Vara que o processo pertence
- Vencimento: Data de vencimento do registro
Parâmetros
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
CPF | string | Não | O parâmetro CPF pode ser enviado com ou sem formatação. |
TOKEN | string | Sim | O parâmetro TOKEN é essencial para efetuar esta consulta. Em caso de dúvidas, por favor, entre em contato com: suporte@directd.com.br |
Exemplo de Resposta
{
"metaDados": {
"consultaNome": "string",
"consultaUid": "string",
"chave": "string",
"usuario": "string",
"mensagem": "string",
"ip": "string",
"resultadoId": 0,
"resultado": "string",
"apiVersao": "v3",
"enviarCallback": false,
"gerarComprovante": false,
"urlComprovante": "string",
"assincrono": true,
"data": "dd/MM/yyyy HH:mm:ss",
"tempoExecucaoMs": 0
},
"retorno": {
"cpf": "string",
"cpfSituacao": "string",
"cpfOrigem": "string",
"cpfDataAtualizacaoReceita": "string",
"rg": "string",
"rguf": "string",
"rgDataEmissao": "string",
"nome": "string",
"nomeSocial": "string",
"nomePai": "string",
"mae": "string",
"nascimento": "string",
"sexo": "string",
"nacionalidade": "string",
"naturalidade": "string",
"grauInstrucao": "string",
"estadoCivil": "string",
"numeroDependentes": "string",
"indicacaoObito": "string",
"tituloEleitor": "string",
"numeroPIS": "string",
"cartaoNacionalSaude": "string",
"email": "string",
"faixaRenda": "string",
"classeSocial": "string",
"poderAquisitivo": "string",
"ultimoImpostoRenda": "string",
"qtdDependentesBolsaFamilia": "string",
"telefones": [
{
"ddd": "string",
"numero": "string",
"telefoneComDDD": "string"
}
],
"enderecos": [
{
"logradouro": "string",
"numero": "string",
"complemento": "string",
"bairro": "string",
"cidade": "string",
"uf": "string",
"cep": "string"
}
],
"restricoes": {
"quantidadeOcorrencias": "string",
"ocorrencias": [
{
"codigoInformacao": "string",
"descricaoInformacao": "string",
"titulo": "string",
"observacao": "string"
}
]
},
"participacaoEmEmpresas": {
"quantidadeOcorrencias": "string",
"ocorrencias": [
{
"cnpj": "string",
"razaoSocial": "string",
"participanteTipo": "string",
"participanteDocumento": "string",
"participanteCargo": "string",
"participanteEntrada": "string",
"participacao": "string",
"quantidadeOutrosSocios": "string"
}
]
},
"pendenciasFinanceiras": {
"quantidadeOcorrencia": "string",
"valorTotal": "string",
"ultimoVencimento": "string",
"dataPrimeiro": "string",
"totalCredores": "string",
"valorMaior": "string",
"valorPrimeiro": "string",
"periodoInicial": "string",
"periodoFinal": "string",
"dataMaior": "string",
"provedores": [
{
"provedor": "string"
}
],
"ocorrencias": [
{
"dataVencimento": "string",
"dataInclusao": "string",
"informante": "string",
"tipoDevedor": "string",
"credor": "string",
"moeda": "string",
"valor": "string",
"contrato": "string",
"origem": "string",
"subjudice": "string",
"modalidade": "string",
"entidade": "string"
}
]
},
"protestos": {
"quantidadeOcorrencia": "string",
"valorTotal": "string",
"ultimoProtesto": "string",
"dataPrimeiro": "string",
"valorPrimeiro": "string",
"dataUltimo": "string",
"valorUltimo": "string",
"dataMaior": "string",
"valorMaior": "string",
"ocorrencias": [
{
"data": "string",
"moeda": "string",
"valor": "string",
"valorCustas": "string",
"quantidade": "string",
"cartorio": "string",
"origem": "string",
"credor": "string",
"anuencia": "string",
"tipoAnotacao": "string",
"subjudice": "string",
"vencimento": "string"
}
]
},
"chequeSemFundoVarejo": {
"quantidadeOcorrencia": "string",
"correntista": "string",
"tipoPessoa": "string",
"documento": "string"
},
"chequeSemFundoBacen": {
"quantidadeOcorrencia": "string",
"correntista": "string",
"tipoPessoa": "string",
"documento": "string"
},
"falenciasAcoesRecuperacoes": {
"quantidadeOcorrencia": "string",
"valorTotal": "string",
"ultimoRegistro": "string",
"ocorrencias": [
{
"tipo": "string",
"quantidade": "string",
"cartorio": "string",
"data": "string",
"origem": "string",
"valor": "string",
"documento": "string",
"razaoSocial": "string"
}
]
},
"scores": {
"quantidadeOcorrencias": "string",
"ocorrencias": [
{
"layout": "string",
"tipoScore": "string",
"score": "string",
"execucao": "string",
"descricaoPlano": "string",
"descricaoScore": "string",
"classificacaoNro": "string",
"classificacaoABC": "string",
"probabilidadeInadimplencia": "string",
"texto": "string",
"risco": "string",
"modeloScore": "string",
"informante": "string"
}
]
},
"passagensComerciais": {
"quantidadeOcorrencias": "string",
"ocorrencias": [
{
"dataConsulta": "string",
"horaConsulta": "string",
"clienteConsulta": "string",
"telefoneCliente": "string",
"enderecoCliente": "string"
}
]
},
"acoesCiveis": {
"quantidadeOcorrencia": "string",
"valorTotal": "string",
"valorPrimeiro": "string",
"valorUltimo": "string",
"dataPrimeiro": "string",
"dataUltimo": "string",
"valorMaior": "string",
"valorMenor": "string",
"dataMaior": "string",
"dataMenor": "string",
"ocorrencias": [
{
"requerido": "string",
"valor": "string",
"acao": "string",
"documento": "string",
"foro": "string",
"origem": "string",
"vara": "string",
"comarca": "string",
"autor": "string",
"processo": "string",
"dataDistribuicao": "string"
}
]
},
"decisao": {
"codigoSituacao": "string",
"descricao": "string",
"resultado": "string",
"layout": "string"
},
"rendaPresumida": {
"descricao": "string",
"faixa": "string",
"rendaAnual": "string",
"mensagem": "string",
"dataReferencia": "string",
"valorPresumido": "string",
"dadosCadastroPositivo": "string"
},
"controlePositivo": {
"ocorrenciasFaturasEmAtraso": [
{
"notaComportamentoFaturaEmAtraso": "string"
}
],
"ocorrenciasNotaComportamentosContratosRecentes": [
{
"nota": "string"
}
]
}
}
}Erros Comuns
| Código | Descrição |
|---|---|
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. |
Notas Importantes
- Para obter o comprovante desta consulta, utiliza-se: '&GerarComprovante=habilitar' na URL
- Para utilizar a consulta de forma assíncrona, utiliza-se: '&async=habilitar' na URL
- Em caso de dúvidas/suporte, entre em contato pelo e-mail: suporte@directd.com.br ou pelo nosso WhatsApp: (11) 93906-9228