# Consulta Nacional

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

- **Identificador:** `veiculos/consulta-nacional`
- **Categoria:** Veículos
- **Audiência:** Veículo
- **Endpoint:** `POST /api/v1/{tenant}/veiculos/consulta-nacional`
- **Preço de tabela:** R$ 4,480 por consulta bem-sucedida
- **Página:** https://www.proteo.com.br/api/consultas/veiculos/consulta-nacional

## 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.

## Parâmetros (corpo JSON)

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

## Campos de retorno (`data`)

| 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 (valores fictícios)

```json
{
  "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"
}
```