💡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.
Introdução
A API Histórico de Veículos PF e PJ fornece:
- Informações detalhadas de veículos associados a CPF/CNPJ
- Dados específicos de veículos por placa
- Histórico de propriedade
- Dados de licenciamento
- Endereços relacionados
Observação: A consulta pode não apresentar os veículos mais atuais já que a API é atualizada anualmente.
URL Base
A API está hospedada no seguinte endereço:
https://apiv3.directd.com.br
Endpoint
Histórico de Veículos
GET /api/Veiculos
Descrição: Endpoint para realizar a consulta Histórico de Veículos PF e PJ. Obs: esta consulta não possui comprovante. Informe apenas um único documento por requisição.
Autenticação
Para acessar esta API, é necessário fornecer um token de autenticação.
Regras de Autenticação:
- O token deve ser enviado como parâmetro na URL da requisição.
- O token é obrigatório para realizar consultas.
- Em caso de dúvidas sobre o token, entre em contato com: suporte@directd.com.br
Campos da API
Dados do Veículo
- Placa: Placa do veículo
- Marca e Modelo: Marca e modelo do veículo
- RENAVAM: Registro Nacional de Veículos Automotores
- Chassi: Número do chassi
- Ano de Fabricação: Ano em que o veículo foi fabricado
- Ano do Modelo: Ano do modelo do veículo
- Data do Licenciamento: Data do último licenciamento
- Documento: CPF/CNPJ do proprietário
- Proprietário: Nome do proprietário
Dados de Endereço
- Logradouro: Nome da rua/avenida
- Número: Número do endereço
- Complemento: Informações adicionais do endereço
- Bairro: Bairro
- Cidade: Cidade
- UF: Estado
- CEP: Código postal
Parâmetros
Nome | Tipo | Obrigatório | Descrição |
---|---|---|---|
CPF | string | Não* | CPF do proprietário. Pode ser enviado com ou sem formatação. |
CNPJ | string | Não* | CNPJ do proprietário. Pode ser enviado com ou sem formatação. |
PLACA | string | Não* | Placa do veículo. Pode ser enviada com ou sem formatação. |
TOKEN | string | Sim | Token de autenticação necessário para a consulta. |
*É necessário informar pelo menos um dos parâmetros: CPF, CNPJ ou PLACA.
Exemplos de Requisição
Usando cURL - Consulta por CPF
curl 'https://apiv3.directd.com.br/api/Veiculos?CPF=12345678900&TOKEN=seu_token_aqui'
Usando cURL - Consulta por CNPJ
curl 'https://apiv3.directd.com.br/api/Veiculos?CNPJ=12345678000100&TOKEN=seu_token_aqui'
Usando cURL - Consulta por Placa
curl 'https://apiv3.directd.com.br/api/Veiculos?PLACA=ABC1234&TOKEN=seu_token_aqui'
Respostas
Sucesso (200)
Exemplo de Resposta
{
"metaDados": {
"consultaNome": "string",
"consultaUid": "string",
"chave": "string",
"usuario": "string",
"mensagem": "string",
"ip": "string",
"resultadoId": 0,
"resultado": "string",
"apiVersao": "v3",
"gerarComprovante": false,
"urlComprovante": "string",
"assincrono": true,
"data": "dd/MM/yyyy HH:mm:ss",
"tempoExecucaoMs": 0
},
"retorno": {
"veiculos": [
{
"documento": "string",
"proprietario": "string",
"placa": "string",
"marcaModelo": "string",
"renavam": "string",
"chassi": "string",
"anoFabricacao": "string",
"anoModelo": "string",
"dataLicenciamento": "string"
}
],
"enderecos": [
{
"logradouro": "string",
"numero": "string",
"complemento": "string",
"bairro": "string",
"cidade": "string",
"uf": "string",
"cep": "string"
}
]
}
}
Outros Códigos de Resposta
Código | Descrição |
---|---|
201 | Sucesso: a requisição async foi criada com sucesso e está em processamento. |
202 | Em Processamento: a requisição async ainda está em processamento. |
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. |
Aplicações
- Análise de Crédito
- Gestão de Cobrança
- Análise Comportamental
- Compliance/ESG
- Due Diligence
- Verificação de Ativos
Notas Importantes
- O valor da consulta é de R$ 0,36
- A API está na versão v3
- Esta consulta não possui comprovante
- A base de dados é atualizada anualmente
- Para suporte técnico, entre em contato com suporte@directd.com.br
- Fonte: Fornecedor Externo