A API Histórico de Veículos PF e PJ retorna informações detalhadas sobre o histórico de veículos de uma Pessoa Física ou Jurídica com base no CNPJ, CPF ou placa do veículo. Esta consulta aponta todos os veículos relacionados com o documento consultado, principalmente para fins de análise de crédito, cobrança e comportamental.
Histórico de Veículos PF e PJ
Retorna informações detalhadas sobre o histórico de veículos de uma Pessoa Física ou Jurídica com base no CNPJ ou CPF. Esta consulta aponta todos os veículos relacionados com o documento consultado, principalmente para fins de analise credito, cobrança e comportamental. Caso seja consultada a placa do veículo, retorna as informações detalhadas do veículo consultado. A consulta pode não apresentar os veículos mais atuais já que a API é atualizada anualmente.
Casos de Uso
- Integração com Histórico de Veículos PF e PJ
- Análise de histórico para compra e venda de veículos
- Subscrição e precificação de seguros
- Gestão de frotas com dados confiáveis
Aplicações
- Compliance/ESG
Benefícios
- Documentação de Histórico de Veículos PF e PJ acessível e atualizada
- Reduz riscos de fraudes e sinistros
- Melhor precificação com histórico completo
- Dados integrados e atualizados
URL Base
A API está hospedada no seguinte endereço:
https://apiv3.directd.com.br/api/HistoricoVeiculosVeiculoEndpoint
GET https://apiv3.directd.com.br/api/HistoricoVeiculosVeiculo?Cpf={0]&Cnpj={1}&Token=Seu_TokenDescrição: Endpoint para realizar consultas Histórico de Veículos PF e PJ.
Nota: Esta consulta não gera comprovantes.
Campos Retornados
- Ano de Fabricação: Informa o ano de fabricação.
- Ano do Modelo: Informa o ano do modelo do veículo.
- Bairro: Bairro do endereço
- CEP: Número CEP do endereço
- Chassi: Informa o casshi do veículo.
- Cidade: Cidade do registro em questão
- Complemento: Complemento do endereço do registro em questão
- Data do Lincenciamento: Informa a data de licenciamento.
- Documento: Documento referente ao CPF/CNPJ
- Lista de Endereço: Lista os endereços do indivíduo
- Lista de Veículos: Lista os veículos vinculados.
- Logradouro: Nome da rua, avenida, travessa, alameda ou outros onde está localizado o endereço.
- Marca e Modelo: Informa a marca e modelo do veículo.
- Número: Número do registro em questão
- Placa: Informa a placa do veículo.
- Proprietário: Detalhes sobre o proprietário.
- RENAVAM: Informa o código RENAVAM do veículo
- UF: Unidade Federativa (estado) referente ao registro
Parâmetros
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
CNPJ | string | Não | O parâmetro CNPJ pode ser enviado com ou sem formataçã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": {
"documento": "string",
"proprietario": "string",
"veiculos": [
{
"placa": "string",
"veiculo": "string",
"marca": "string",
"modelo": "string",
"renavam": "string",
"chassi": "string",
"dataAquisicao": "string"
}
],
"enderecos": [
{
"logradouro": "string",
"numero": "string",
"complemento": "string",
"bairro": "string",
"cidade": "string",
"uf": "string",
"cep": "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
- Informe apenas um único documento por requisição
- 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