API - Consulta Veicular

/api/ConsultaVeicular

💡 O endpoint /api/ConsultaVeicular permite obter informações completas sobre um veículo a partir de sua placa, incluindo dados como marca, modelo, ano de fabricação, cor e demais características técnicas. A consulta também retorna informações do proprietário e o valor médio de mercado atualizado conforme a Tabela Fipe, proporcionando uma visão detalhada e confiável tanto do veículo quanto de seu proprietário.

Introdução

A API Consulta Veicular oferece uma análise completa de veículos, possibilitando:

• Consulta detalhada por placa ou chassi;
• Informações técnicas completas do veículo;
• Dados do proprietário;
• Valor de mercado atualizado (Tabela FIPE);
• Características técnicas e especificações;
• Situação atual do veículo.

Essa API é ideal para compliance/ESG e análise de ativos veiculares.

Fonte: Indisponível

URL Base

A API está hospedada no seguinte endereço:

https://apiv3.directd.com.br

Endpoint

GET /api/ConsultaVeicular

Esse endpoint retorna informações detalhadas sobre veículos a partir da placa ou chassi consultado.

Regras

1. Informe apenas um único documento por requisição (PLACA ou CHASSI).
2. Esta consulta não possui comprovante.
3. Retorna informações completas do veículo e proprietário.

Autenticação

A autenticação é feita utilizando um TOKEN. Sem um token válido, o acesso será negado (401).

Regras de Autenticação

1. O TOKEN deve ser incluído como parâmetro obrigatório.
2. Caso o token seja inválido ou expirado, entre em contato pelo e-mail: suporte@directd.com.br.

Campos da API

Dados do Proprietário

• Proprietário: Nome do proprietário do veículo
• Documento: CPF/CNPJ do proprietário
• Ano de Exercício: Ano de exercício da consulta
• Ano de Competência: Ano de competência da consulta
• Mês de Competência: Mês de competência da consulta

Dados do Veículo

• RENAVAM: Registro Nacional de Veículos Automotores
• Placa: Placa do veículo
• UF: Unidade Federativa de registro
• Chassi: Número do chassi
• Município: Município de registro
• Marca: Marca do veículo
• Modelo: Modelo do veículo
• Ano do Modelo: Ano do modelo
• Ano de Fabricação: Ano de fabricação
• Tipo: Tipo do veículo
• Combustível: Tipo de combustível
• Cor: Cor do veículo
• Espécie: Espécie do veículo
• Situação do Veículo: Situação atual do veículo
• Procedência do Veículo: Procedência do veículo

Características Técnicas

• Número do Motor: Número do motor
• Número do Câmbio: Número do câmbio
• Número da Carroceria: Número da carroceria
• Número do Eixo Traseiro: Número do eixo traseiro
• Número dos Eixos: Número total de eixos
• Número do Eixo Auxiliar: Número do eixo auxiliar
• Capacidade de Passageiros: Capacidade de passageiros
• Cilindrada: Cilindrada do motor
• Capacidade de Carga: Capacidade de carga

Valor FIPE

• Mês: Mês de referência da tabela FIPE
• Ano: Ano de referência da tabela FIPE
• Valor: Valor médio de mercado conforme FIPE

Parâmetros

*É necessário informar PLACA ou CHASSI (apenas um por requisição).

Exemplo de Requisição

Usando cURL - Consulta por Placa

curl -X 'GET' \
  'https://apiv3.directd.com.br/api/ConsultaVeicular?PLACA=ABC1234&TOKEN=68ADA2C3-8016-47DA-ADE6-13AE239308FE' \
  -H 'accept: application/json'

Usando cURL - Consulta por Chassi

curl -X 'GET' \
  'https://apiv3.directd.com.br/api/ConsultaVeicular?CHASSI=9BWZZZZ377P404012&TOKEN=68ADA2C3-8016-47DA-ADE6-13AE239308FE' \
  -H 'accept: application/json'

Respostas

Sucesso (200)

A consulta foi realizada com sucesso e retorna os dados completos do veículo.

Exemplo de Resposta

{
  "metaDados": {
    "consultaNome": "Consulta Veicular",
    "consultaUid": "direct-123456",
    "chave": "ABC1234",
    "mensagem": "Consulta realizada com sucesso.",
    "resultado": "Sucesso",
    "apiVersao": "v3",
    "tempoExecucaoMs": 150
  },
  "retorno": {
    "proprietario": "João da Silva",
    "documento": "12345678901",
    "anoExercicio": "2024",
    "veiculo": {
      "renavam": "12345678901",
      "placa": "ABC1234",
      "uf": "SP",
      "chassi": "9BWZZZZ377P404012",
      "municipio": "São Paulo",
      "marca": "Volkswagen",
      "modelo": "Golf",
      "anoModelo": "2020",
      "anoFabricacao": "2020",
      "tipo": "Automóvel",
      "combustivel": "Flex",
      "cor": "Branco",
      "numeroMotor": "123456789",
      "numeroCambio": "987654321",
      "numeroCarroceria": "111222333",
      "numeroEixoTraseiro": "444555666",
      "numeroEixos": "2",
      "numeroDoEixoAuxiliar": "777888999",
      "especie": "Particular",
      "situacaoVeiculo": "Ativo",
      "procedenciaVeiculo": "Nacional",
      "capacidadedePassageiros": "5",
      "cilindrada": "1600",
      "capacidaDeCarga": "0",
      "fipe": {
        "mes": "12",
        "ano": "2024",
        "valor": "R$ 85.000,00"
      }
    }
  }
}

Erros Comuns

Aplicações

• Compliance/ESG

Notas Importantes

• Informe apenas um parâmetro por requisição (PLACA ou CHASSI).
• Esta consulta não gera comprovante em PDF.
• O valor por consulta é de R$ 6,00.
• Para dúvidas ou suporte, entre em contato pelo e-mail: suporte@directd.com.br.
• Fonte: Indisponível