
# Tipos de consulta

A mesma URL faz consultas diferentes. Você escolhe com o parâmetro `tipo`, e cada tipo tem o seu preço, descontado do saldo **só quando o dado é encontrado**.

```http
GET https://api.placaefipe.com.br/v1/placas/{placa}?tipo=completa
```

Sem `tipo`, a consulta é `basica`.

## Resumo

Preços de lançamento, com 50% de desconto.

| `tipo` | Nome | Preço | FIPE | Chassi completo | Renavam | Nº do motor |
|---|---|---|---|---|---|---|
| `basica` | Consulta básica + FIPE | de R$ 0,18 por **R$ 0,09** | sim | não (só o final) | não | não |
| `completa` | Consulta completa | de R$ 1,20 por **R$ 0,60** | sim | sim | sim | sim |
| `renavam` | Consulta Renavam | de R$ 0,72 por **R$ 0,36** | não | não | sim | não |
| `chassi` | Consulta de chassi | de R$ 0,72 por **R$ 0,36** | não | sim | não | não |
| `motor` | Consulta de número do motor | de R$ 0,72 por **R$ 0,36** | não | não | não | sim |

Também aceitamos estes apelidos: `basico` e `simples` (= `basica`), `completo` e `full` (= `completa`) e `vin` (= `chassi`). Qualquer outro valor devolve `400 tipo_invalido`.

A tabela também sai em JSON, sem chave, em `GET https://api.placaefipe.com.br/v1/precos`. Veja [Saldo e preços](/docs/saldo).

## Básica + FIPE (`basica`)

**R$ 0,09** por consulta (de R$ 0,18). É o tipo padrão.

Retorna marca, modelo, versão, ano de fabricação e modelo, cor, combustível, município, UF, situação, final do chassi (`chassi_final`, 5 últimos caracteres), dados técnicos (`tecnico`) e o valor da Tabela FIPE do mês (`fipe`).

**Quando usar:** cadastro de veículo, preenchimento automático de formulário, cotação de seguro, avaliação de usado, oficina, frota. Na maioria dos sistemas, é a única consulta de que você precisa.

## Completa (`completa`)

**R$ 0,60** por consulta (de R$ 1,20).

Retorna tudo da básica + FIPE e mais o objeto `identificacao`:

```json
"identificacao": {
  "chassi": "9BWZZZ377VT004251",
  "renavam": "00123456789",
  "numero_motor": "BJG123456"
}
```

**Quando usar:** quando o sistema precisa identificar o veículo com precisão, além dos dados e da FIPE. Seguradoras, lojas de veículos, despachantes, vistoria e oficinas que conferem chassi e motor.

## Renavam (`renavam`)

**R$ 0,36** por consulta (de R$ 0,72).

Retorna só `placa`, `tipo`, `identificacao.renavam` e `consulta`. Não vêm dados do veículo nem FIPE.

**Quando usar:** você já tem os dados do veículo e só falta o Renavam, por exemplo para emitir documento, consultar débitos ou licenciamento.

## Chassi (`chassi`)

**R$ 0,36** por consulta (de R$ 0,72).

Retorna só `placa`, `tipo`, `identificacao.chassi` (chassi completo, o VIN de 17 caracteres) e `consulta`.

**Quando usar:** vistoria, conferência de identificação e busca de peças pelo VIN, quando os outros dados já estão no seu cadastro.

## Número do motor (`motor`)

**R$ 0,36** por consulta (de R$ 0,72).

Retorna só `placa`, `tipo`, `identificacao.numero_motor` e `consulta`.

**Quando usar:** vistoria, troca de motor e conferência de documentação.


## Qual escolher

- Precisa de dados do veículo e/ou FIPE? **`basica`.**
- Precisa de dados + FIPE **e** de pelo menos dois entre chassi, Renavam e motor? **`completa`**: sai mais barato que a básica mais dois avulsos (R$ 0,09 + R$ 0,72 = R$ 0,81).
- Precisa só de um desses números, sem os dados do veículo? O avulso: **`renavam`**, **`chassi`** ou **`motor`**.
- Precisa de dados + FIPE e de **um só** desses números? Compare: `completa` (R$ 0,60) traz tudo numa chamada; `basica` + avulso custa R$ 0,45, mas são duas chamadas.

## O que não vendemos de propósito

- **FIPE avulsa:** a básica já traz a FIPE junto com os dados do veículo por R$ 0,09, mais barato do que uma FIPE separada custaria.
- **Motor + chassi juntos:** a completa já traz os dois e ainda o Renavam por R$ 0,60, menos do que motor e chassi avulsos somados (R$ 0,72).

## Regras que valem para todos os tipos

- O preço só é descontado quando o dado é encontrado. `404 placa_nao_encontrada` e qualquer erro não descontam nada.
- Se o saldo não cobre o tipo pedido, a API responde `402 saldo_insuficiente` e não consulta. Pode haver saldo para uma básica e não para uma completa.
- Nenhum tipo retorna dados do proprietário (nome, CPF, endereço), por causa da LGPD.
- Com chave de teste (`pf_test_...`), todos os tipos devolvem dados de exemplo, de graça (`valor_cobrado: 0`, `cobrada: false`).
- Trate `identificacao` e cada campo dentro dela como opcionais: podem vir `null` quando o registro não tem a informação.

Campos e exemplos completos de resposta em [Consultar placa](/docs/consultar-placa).
