> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sherlocker.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Veículo

> Veículo automotor registrado no DENATRAN

Um **Veículo** representa um veículo automotor (carro, moto, caminhão, ônibus) registrado no sistema nacional de trânsito.

## Tipagem

```json theme={null}
{
  "documento": "91805040600",
  "tipo": "PF",
  "nome_proprietario": "HELENICE LUZIA PEREZ",
  "ano_documento": 2025,
  "placa": "QPS0133",
  "placa_antiga": "QPS0133",
  "placa_nova": "",
  "renavam": "1173451703",
  "chassi": "93YRBB005KJ664188",
  "ano_fabricacao": 2018,
  "ano_modelo": 2019,
  "marca": "RENAULT",
  "modelo": "KWID ZEN 10MT",
  "cor": "Branca",
  "combustivel": "Alcool / Gasolina",
  "tipo_veiculo": "Automovel",
  "especie_veiculo": "Passageiro",
  "potencia": "70",
  "cilindradas": "999",
  "quantidade_passageiro": "5",
  "municipio": "Belo Horizonte",
  "uf": "MG",
  "situacao_veiculo": "Regular",
  "nacionalidade": "Nacional",
  "carroceria": "",
  "tipo_montagem": "Completa",
  "peso_bruto_total": "116",
  "cap_maxima_tracao": "116",
  "capacidade_carga": "0",
  "motor": "B4DA402Q084089",
  "caixa_cambio": "",
  "situacao_chassi": "Normal",
  "eixos": "2",
  "media_preco": "",
  "updated_at": 0,
  "restricoes": []
}
```

## Campos

| Campo                   | Tipo           | Descrição                                              |
| ----------------------- | -------------- | ------------------------------------------------------ |
| `documento`             | string         | CPF ou CNPJ do proprietário                            |
| `tipo`                  | string         | `PF` ou `PJ`                                           |
| `nome_proprietario`     | string         | Nome do proprietário                                   |
| `ano_documento`         | number         | Ano do documento                                       |
| `placa`                 | string         | Placa atual                                            |
| `placa_antiga`          | string         | Placa formato antigo                                   |
| `placa_nova`            | string         | Placa formato Mercosul (string vazia se não houver)    |
| `renavam`               | string         | Código RENAVAM                                         |
| `chassi`                | string         | Número do chassi                                       |
| `ano_fabricacao`        | number         | Ano de fabricação                                      |
| `ano_modelo`            | number \| null | Ano do modelo (`null` quando desconhecido)             |
| `marca`                 | string         | Fabricante (ex: `RENAULT`, `FIAT`)                     |
| `modelo`                | string         | Modelo do veículo (ex: `KWID ZEN 10MT`)                |
| `cor`                   | string         | Cor predominante                                       |
| `combustivel`           | string         | Tipo de combustível                                    |
| `tipo_veiculo`          | string         | `Automovel`, `Motocicleta`, `Caminhonete`, etc.        |
| `especie_veiculo`       | string         | Espécie do veículo                                     |
| `potencia`              | string         | Potência em CV                                         |
| `cilindradas`           | string         | Cilindradas em CC                                      |
| `quantidade_passageiro` | string         | Capacidade de passageiros                              |
| `municipio`             | string         | Município de registro                                  |
| `uf`                    | string         | UF de registro                                         |
| `situacao_veiculo`      | string         | Situação do veículo                                    |
| `restricoes`            | string\[]      | Array de restrições ativas (vazio se nenhuma)          |
| `nacionalidade`         | string         | Código de nacionalidade                                |
| `carroceria`            | string         | Tipo de carroceria (string vazia se não houver)        |
| `tipo_montagem`         | string         | Tipo de montagem                                       |
| `peso_bruto_total`      | string         | Peso bruto total (kg)                                  |
| `cap_maxima_tracao`     | string         | Capacidade máxima de tração (kg)                       |
| `capacidade_carga`      | string         | Capacidade de carga (kg)                               |
| `motor`                 | string         | Número do motor                                        |
| `caixa_cambio`          | string         | Número da caixa de câmbio (string vazia se não houver) |
| `situacao_chassi`       | string         | Situação do chassi (`N` = normal)                      |
| `eixos`                 | string         | Quantidade de eixos                                    |
| `media_preco`           | string         | Média de preço FIPE (string vazia se não houver)       |
| `updated_at`            | number         | Timestamp da última atualização do registro            |

## Endpoints

| Rota                          | Descrição                     |
| ----------------------------- | ----------------------------- |
| `GET /veiculos/cpf/{cpf}`     | Veículos por proprietário     |
| `GET /veiculos/cnpj/{cnpj}`   | Frota da empresa              |
| `GET /veiculos/placa/{placa}` | Identificar veículo por placa |