API Exclusiva

Orientações e respostas da equipe da Direct Data

Artigo do Blog

Consulta Veicular

A Consulta Veicular 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, proporcionando uma visão detalhada e confiável tanto do veículo quanto de seu proprietário.

Casos de Uso

  • Integração com Consulta Veicular
  • 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 Consulta Veicular acessível e atualizada
  • Reduz riscos de fraudes e sinistros
  • Melhor precificação com histórico completo
  • Dados integrados e atualizados

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.

URL Base

A API está hospedada no seguinte endereço:

https://apiv3.directd.com.br/api/ConsultaVeicular

Endpoint

GET https://apiv3.directd.com.br/api/ConsultaVeicular?Placa={0}&Token=Seu_Token

Descrição: Endpoint para realizar consultas Consulta Veicular .

Nota: Esta consulta não gera comprovantes.

Campos Retornados

  • Ano de Competência: Ano de competência da parcela
  • Ano de Exercício: Informa o ano de exercício.
  • Ano de Fabricação: Informa o ano de fabricação.
  • Ano do Modelo: Informa o ano do modelo do veículo.
  • Capacidade de Carga: Informa a capacidade de carga do veículo.
  • Capacidade de Passageiros: Informa a capacidade de passageiros do veículo.
  • Capacidade Máxima de Carga: Capacidade máxima de carga do veículo
  • Capacidade Máxima de Tração: Capacidade máxima de tração (CMT) do veículo
  • Categoria: Nome da Categoria
  • Chassi: Informa o casshi do veículo.
  • Cilindrada: Informa a cilindrada do veículo.
  • Combustível: Informa qual o tipo de combustível utilizado pelo veículo.
  • Cor: Informa a cor do veículo.
  • Data de Emissão do CRLV: Data de emissão do Certificado de Registro e Licenciamento de Veículo
  • Data de Emissão do CRV: Data de emissão do Certificado de Registro de Veículo.
  • Descrição da Remarcação de Chassi: Descrição detalhada sobre a remarcação do chassi, quando houver.
  • Documento: Documento referente ao CPF/CNPJ
  • Espécie: Informa a espécie do veículo.
  • Faturado: Objeto contendo informações de faturamento do veículo
  • FIPE: Detalhes sobre o veículo na tabela FIPE.
  • Flag Alarme: Indica se o veículo possui alarme registrado. True(verdadeiro) ou false(falso)
  • Flag Comunicado de Venda: Indica se há comunicado de venda registrado para o veículo. True(verdadeiro) ou false(falso)
  • Flag Leilão: Indica se o veículo está ou já esteve em leilão. True(verdadeiro) ou false(falso)
  • Flag Pendência de Emissão: Indica se há pendência de emissão do documento do veículo. True(verdadeiro) ou false(falso)
  • Flag Recall: Indica se o veículo possui recall registrado pelo fabricante. True(verdadeiro) ou false(falso)
  • Flag Remarcação de Chassi: Indica se houve remarcação no chassi do veículo. True(verdadeiro) ou false(falso).
  • Flag RENAINF: Indica se o veículo possui infrações registradas no RENAINF. True(verdadeiro) ou false(falso)
  • Flag RENAJUD: Indica se o veículo possui restrição judicial registrada no RENAJUD. True(verdadeiro) ou false(falso)
  • Flag RFB: Indica se o veículo possui restrição junto à Receita Federal do Brasil. True(verdadeiro) ou false(falso)
  • Flag Roubo ou Furto: Indica se o veículo possui ocorrência de roubo ou furto registrada. True(verdadeiro) ou false(falso)
  • Importação: Objeto contendo informações de importação do veículo.
  • Indicadores: Informações a respeito dos indicadores da entidade
  • Marca: Informa a marca do veículo.
  • Mês de Competência: Mês de competência da parcela
  • Modelo: Informa o modelo do veículo.
  • Município: Município/cidade referente ao registro
  • Número da Carroceria: Informa o número da carroceria do veículo.
  • Número da Declaração: Número da declaração de importação do veículo
  • Número do Câmbio: Informa o número do câmbio.
  • Número do Eixo Auxiliar: Informa o número do eixo auxiliar do veículo.
  • Número do Eixo Traseiro: Informa o número do eixo traseiro do veículo.
  • Número do Motor: Informa o número do motor.
  • Número dos Eixos: Informa o número dos eixos do veículo.
  • Peso Bruto Total: Peso bruto total (PBT) do veículo.
  • Placa: Informa a placa do veículo.
  • Potência: Potência do motor do veículo.
  • Procedência do Veículo: Informa a procedência do veículo.
  • Proprietário: Detalhes sobre o proprietário.
  • RENAVAM: Informa o código RENAVAM do veículo
  • Restrições: Detalhes sobre as restrições as quais a entidade ou agente possui.
  • Situação do Veículo: Informa a situação do veículo.
  • Tipo: Tipo do registro em questão
  • Tipo de Carroceria: Tipo de carroceria do veículo
  • UF: Unidade Federativa (estado) referente ao registro
  • Valor: Valor da parcela
  • Veículo: Informa detalhes sobre o veículo.

Parâmetros

ParâmetroTipoObrigatórioDescrição
PLACAstring
Sim

O parâmetro PLACA pode ser enviado com ou sem formatação.

TOKENstring
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": {
    "proprietario": "string",
    "documento": "string",
    "anoExercicio": "string",
    "veiculo": {
      "renavam": "string",
      "placa": "string",
      "uf": "string",
      "chassi": "string",
      "municipio": "string",
      "marca": "string",
      "modelo": "string",
      "anoModelo": "string",
      "anoFabricacao": "string",
      "tipo": "string",
      "combustivel": "string",
      "cor": "string",
      "numeroMotor": "string",
      "numeroCambio": "string",
      "numeroCarroceria": "string",
      "numeroEixoTraseiro": "string",
      "numeroEixos": "string",
      "numeroDoEixoAuxiliar": "string",
      "especie": "string",
      "situacaoVeiculo": "string",
      "procedenciaVeiculo": "string",
      "capacidadedePassageiros": "string",
      "cilindrada": "string",
      "capacidaDeCarga": "string",
      "fipe": {
        "mes": "string",
        "ano": "string",
        "valor": "string"
      },
      "dataEmissaoCrlv": "string",
      "dataEmissaoCrv": "string",
      "indicadorRemarcacaoChassi": true,
      "descricaoRemarcacaoChassi": "string",
      "tipoCarroceria": "string",
      "categoria": "string",
      "potencia": 0,
      "pesoBrutoTotal": "string",
      "capacidadeMaximaTracao": "string",
      "capacidadeMaximaCarga": "string",
      "restricoes": [
        "string"
      ],
      "faturado": {
        "documento": "string",
        "tipo": "string"
      },
      "importacao": {
        "numeroDeclaracao": "string",
        "data": "string"
      },
      "indicadores": {
        "renainf": true,
        "comunicadoVenda": true,
        "pendenciaEmissao": true,
        "renajud": true,
        "rfb": true,
        "rouboFurto": true,
        "leilao": true,
        "alarme": true,
        "siniav": true,
        "recall": true
      }
    }
  }
}

Erros Comuns

CódigoDescriçã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 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