Veículos

Consulta Nacional

O serviço de Consulta Nacional retorna informações sobre veículos no mercado brasileiro, considerando modelo, ano, marca e versão.

Falar com o comercial Ver o catálogo

Quando usar

Descrição

O serviço de Consulta Nacional fornece informações sobre veículos no mercado brasileiro, considerando modelo, ano, marca e versão.

Requisição

Autenticação por chave de API (cabeçalho Authorization: Bearer), criada no painel com esta consulta no escopo.

POST /api/v1/{tenant}/veiculos/consulta-nacional

Campo	Obrigatório	Descrição
`plate`	sim	Placa do veículo, antiga ou Mercosul.

{
  "plate": "ABC1D23"
}

Campos de retorno

Campos dentro de data. [] indica lista.

Campo	Tipo
`identificacao.placa`	texto
`identificacao.placaMercosul`	texto
`identificacao.chassi`	texto
`identificacao.renavam`	texto
`situacao.veiculo`	booleano
`situacao.statusDescricao`	texto
`situacao.remarcado`	booleano
`situacao.rouboFurto`	booleano
`situacao.dataUltimaAtualizacao`	texto
`proprietario.nome`	texto
`proprietario.documento`	texto
`proprietario.tipoDocumento`	texto
`marca.descricao`	texto
`marca.fipeId`	número
`marca.sintetico`	booleano
`modelo.descricao`	texto
`modelo.sintetico`	booleano
`modelo.bruto`	texto
`modelo.versao`	texto
`modelo.anoFabricacao`	número
`modelo.anoModelo`	número
`motor.numero`	texto
`motor.potencia`	número
`motor.cilindradas`	texto
`transmissao.caixaCambio`	texto
`transmissao.numeroCaixaCambio`	texto
`classificacao.tipoVeiculo`	texto
`classificacao.especie`	texto
`classificacao.categoria`	texto
`classificacao.combustivel`	texto
`carroceria.tipo`	texto
`carroceria.numero`	texto
`carroceria.capacidadeCarga`	texto
`dimensoes.quantidadeEixo`	número
`dimensoes.numeroEixoTraseiro`	texto
`dimensoes.numeroTerceiroEixo`	texto
`dimensoes.quantidadeLugares`	número
`dimensoes.capacidadeMaximaTracao`	número
`dimensoes.pesoBrutoTotal`	número
`cor.descricao`	texto
`origem.procedencia`	texto
`origem.nacionalidade`	texto
`localizacao.uf`	texto
`localizacao.cidade`	texto
`faturado.documento`	texto
`faturado.tipo`	texto
`faturado.uf`	texto
`importacao.numeroDI`	texto
`importacao.tipoDocumentoImportadora`	texto
`restricoes.comunicacaoVenda`	booleano
`restricoes.renajud`	booleano
`restricoes.recall`	texto
`restricoes.renainf`	texto
`restricoes.rfb`	texto

Exemplo de resposta

Estrutura real da resposta, com valores fictícios.

{
  "execution_id": "00000000-0000-0000-0000-000000000000",
  "status": "success",
  "message": "Consulta realizada com sucesso",
  "query_name": "Consulta Nacional",
  "query_slug": "consulta-nacional",
  "data": {
    "identificacao": {
      "placa": "texto",
      "placaMercosul": "texto",
      "chassi": "texto",
      "renavam": "texto"
    },
    "situacao": {
      "veiculo": false,
      "statusDescricao": "texto",
      "remarcado": false,
      "rouboFurto": false,
      "dataUltimaAtualizacao": null
    },
    "proprietario": {
      "nome": "texto",
      "documento": "texto",
      "tipoDocumento": "texto"
    },
    "marca": {
      "descricao": "texto",
      "fipeId": 0,
      "sintetico": false
    },
    "modelo": {
      "descricao": "texto",
      "sintetico": false,
      "bruto": "texto",
      "versao": null,
      "anoFabricacao": 0,
      "anoModelo": 0
    },
    "motor": {
      "numero": "texto",
      "potencia": 0,
      "cilindradas": "texto"
    },
    "transmissao": {
      "caixaCambio": null,
      "numeroCaixaCambio": null
    },
    "classificacao": {
      "tipoVeiculo": "texto",
      "especie": "texto",
      "categoria": "texto",
      "combustivel": "texto"
    },
    "carroceria": {
      "tipo": "texto",
      "numero": null,
      "capacidadeCarga": "texto"
    },
    "dimensoes": {
      "quantidadeEixo": 0,
      "numeroEixoTraseiro": null,
      "numeroTerceiroEixo": null,
      "quantidadeLugares": 0,
      "capacidadeMaximaTracao": 0,
      "pesoBrutoTotal": 0
    },
    "cor": {
      "descricao": "texto"
    },
    "origem": {
      "procedencia": null,
      "nacionalidade": "texto"
    },
    "localizacao": {
      "uf": "texto",
      "cidade": "texto"
    },
    "faturado": {
      "documento": null,
      "tipo": null,
      "uf": "texto"
    },
    "importacao": {
      "numeroDI": "texto",
      "tipoDocumentoImportadora": null
    },
    "restricoes": {
      "comunicacaoVenda": false,
      "renajud": false,
      "recall": null,
      "renainf": null,
      "rfb": null,
      "lista": [

      ]
    }
  },
  "consulted_at": "2026-01-01T12:00:00Z",
  "query_cost": "4.480"
}

Cobrança e respostas

O valor é cobrado por consulta bem-sucedida.
200 — consulta processada (veja status no corpo da resposta)
401 — token ausente, inválido, inativo ou expirado
403 — serviço fora do escopo da chave, IP não autorizado ou limite de consumo excedido
422 — campo obrigatório ausente/inválido ou payload acima do limite do serviço
429 — limite de requisições por minuto da chave excedido
504 — tempo máximo de execução do serviço excedido