Realizar uma consulta

Para iniciar uma consulta, envie a tag do tipo de consulta e a placa ou o chassi do veículo.

Requisição

POST {{host}}/query/new
Content-Type: application/json
x-api-key: {{api-key}}

Corpo da requisição

Com placa:

{
  "tag": "AGGREGATE",
  "licensePlate": "RMN9G52"
}

Com chassi:

{
  "tag": "AGGREGATE",
  "chassis": "9BWZZZ377VT004251"
}

Campo	Obrigatório	Descrição
tag	Sim	Identificador do tipo de consulta (ex.: AGGREGATE)
licensePlate	Um dos dois	Placa do veículo (sem hífen)
chassis	Um dos dois	Chassi do veículo

Informe placa ou chassi — não é necessário enviar os dois.

Resposta

A requisição apenas aceita a consulta para processamento. O resultado completo será enviado para o webhook configurado na sua chave de API quando a consulta estiver pronta.

Consulte Chave de API e webhook para configurar a URL de recebimento.

Exemplo de retorno via webhook (AGGREGATE)

Quando a consulta for concluída com sucesso, seu webhook recebe um payload semelhante a este:

{
  "id": "698b97aff3b697fbce1fd981",
  "type": "AGGREGATE",
  "status": "SUCCESS",
  "response": {
    "agregados": {
      "anoFabricacao": "2021",
      "anoModelo": "2021",
      "caixaCambio": null,
      "capacidadeCarga": null,
      "capacidadePassageiro": "5",
      "capMaxTracao": null,
      "categoria": null,
      "chassi": "999999999999999",
      "municipio": null,
      "cilindradas": 999,
      "codigoCombustivel": null,
      "codigoMarca": null,
      "codigoMarcaModelo": "102652",
      "codigoMunicipio": null,
      "combustivel": "ALCOOL/GASOLINA",
      "corVeiculo": "PRATA",
      "dataEmplacamento": "1970-01-01T00:00:00.000Z",
      "docFaturado": null,
      "docProprietario": null,
      "documentoImportadora": null,
      "dtUltimaAtualizacao": null,
      "eixos": "2",
      "eixoTraseiroDif": null,
      "especieVeiculo": "PASSAGEIRO",
      "familia": null,
      "identImportadora": null,
      "inspecaoGnv": null,
      "limiteRestricaoTrib": null,
      "marca": "FIAT",
      "marcaModelo": null,
      "modelo": "MOBI",
      "municipioEmplacamento": null,
      "nacionalidade": "NACIONAL",
      "numCarroceria": null,
      "numFaturado": "167909999999999",
      "numMotor": null,
      "numTerceiroEixo": null,
      "pbt": null,
      "pesoBrutoTotal": "134",
      "placa": "ABC1234",
      "potencia": 75,
      "procedencia": "NACIONAL",
      "qtdPax": null,
      "renavam": "999999999999999",
      "situacaoChassi": "N",
      "situacaoVeiculo": "S",
      "tipoCarroceria": "Não Aplicável",
      "tipoDocFaturado": "JURÍDICA",
      "tipoDocImportadora": "DESCONHECIDO",
      "tipoMontagem": 1,
      "tipoVeiculo": "AUTOMOVEL",
      "uf": null,
      "ufFaturado": null,
      "ultimaDataInclusao": null,
      "valorAnunciado": null
    }
  },
  "servicesBroken": [],
  "keys": {
    "licensePlate": "ABC1234"
  },
  "createdAt": "2026-02-10T20:40:15.828Z",
  "updatedAt": "2026-02-10T20:40:19.559Z"
}

Campo	Descrição
id	Identificador único da consulta
type	Tipo da consulta (AGGREGATE)
status	Status do processamento (SUCCESS, FAILED, etc.)
response.agregados	Dados agregados do veículo
servicesBroken	Serviços que falharam durante a consulta (vazio quando tudo ok)
keys	Chaves utilizadas na consulta (placa ou chassi)
createdAt / updatedAt	Datas de criação e atualização da consulta