💡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:

  1. O token deve ser enviado como parâmetro na URL da requisição.
  2. O token é obrigatório para realizar consultas.
  3. 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

NomeTipoObrigatórioDescrição
CPFstringNão*CPF do proprietário. Pode ser enviado com ou sem formatação.
CNPJstringNão*CNPJ do proprietário. Pode ser enviado com ou sem formatação.
PLACAstringNão*Placa do veículo. Pode ser enviada com ou sem formatação.
TOKENstringSimToken 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ódigoDescrição
201Sucesso: a requisição async foi criada com sucesso e está em processamento.
202Em Processamento: a requisição async ainda está em processamento.
400Requisição Inválida: a requisição está incorreta ou os parâmetros são inválidos.
401Não Autenticado: o usuário não forneceu as credenciais corretas para acessar o recurso.
403Não Autorizado: o servidor recebeu a requisição, mas se negou a autorizá-la por conta de saldo indisponível.
404Não Encontrado: o servidor não encontrou uma representação atual do recurso solicitado.
408Tempo Esgotado: o servidor não conseguiu retornar a requisição no prazo estabelecido.
500Falha ao Realizar Consulta: o servidor não conseguiu processar a requisição com sucesso. Por favor, entre em contato com o nosso suporte.
503Consulta 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