O endpoint /api/BoaVistaAcertaMaisPositivoPF permite consultar informações completas de uma pessoa física via CPF, incluindo dados cadastrais, score, restrições, pendências financeiras, participação em empresas e histórico no Cadastro Positivo.
Boa Vista - Acerta Mais Positivo Pessoa Física
A API Acerta Mais Positivo CPF consulta informações de pessoas físicas via CPF, incluindo dados cadastrais, score, pendências e histórico no Cadastro Positivo, auxiliando na análise de crédito e tomada de decisão segura.
Casos de Uso
- Análise de crédito para concessão de empréstimos e financiamentos.
- Validação cadastral completa de pessoa física via CPF.
- Consulta de score e probabilidade de inadimplência.
- Identificação de pendências financeiras, protestos e restrições.
- Onboarding digital com validação antifraude.
- Processos de compliance e avaliação de risco.
Aplicações
- Onboarding de Clientes e Fornecedores
- Análise de Risco/Crédito
Benefícios
- Consulta estruturada com dados cadastrais, financeiros e comportamentais.
- Acesso a informações do Cadastro Positivo.
- Visão consolidada de restrições, protestos, cheques sem fundo e ações cíveis.
- Retorno detalhado de score e classificação de risco.
- Possibilidade de geração de comprovante em PDF.
URL Base
A API está hospedada no seguinte endereço:
https://apiv3.directd.com.br/api/BoaVistaAcertaMaisPositivoPFEndpoint
GET https://apiv3.directd.com.br/api/BoaVistaAcertaMaisPositivoPF?CPF={0}&Token=Seu_TokenDescrição: Endpoint para realizar consultas Boa Vista - Acerta Mais 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
- 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 do Participante: Informa a renda do participante.
- 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 | Sim | 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",
"telefone": "string",
"faixaRenda": "string",
"classeSocial": "string",
"poderAquisitivo": "string",
"ultimoImpostoRenda": "string",
"qtdDependentesBolsaFamilia": "string",
"rua": "string",
"bairro": "string",
"cidade": "string",
"uf": "string",
"cep": "string",
"restricoes": {
"quantidadeOcorrencias": "string",
"ocorrencias": [
{
"codigoInformacao": "string",
"descricaoInformacao": "string",
"titulo": "string",
"observacoes": "string"
}
]
},
"participacaoEmEmpresas": {
"quantidadeOcorrencias": "string",
"ocorrencias": [
{
"cnpj": "string",
"razaoSocial": "string",
"participanteTipo": "string",
"participanteDocumento": "string",
"participanteCargo": "string",
"participanteRenda": "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"
}
]
},
"somenteTelefone": {
"registroLocalizado": "string",
"dados": [
{
"codigoIdentificacaoTelefone": "string",
"tipoPessoa": "string",
"documento": "string",
"ddd": "string",
"numeroTelefone": "string",
"tipoTelefone": "string",
"pontuacao": "string"
}
]
},
"somenteEndereco": {
"registroLocalizado": "string",
"dados": [
{
"codigoIdentificacaoEndereco": "string",
"tipoPessoa": "string",
"documento": "string",
"endereco": "string",
"numero": "string",
"complemento": "string",
"bairro": "string",
"cidade": "string",
"uf": "string",
"cep": "string",
"pontuacao": "string",
"latitude": "string",
"longitude": "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",
"observacoes": "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