# Consultar placa

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

Devolve os dados do veículo e a Tabela FIPE do mês. **Consome 1 crédito só quando o veículo é encontrado.**

## Parâmetros

| Nome | Onde | Obrigatório | Descrição |
|---|---|---|---|
| `placa` | caminho | sim | Placa no padrão antigo (`ABC1234`) ou Mercosul (`ABC1D23`). Traço, espaço e minúsculas são aceitos e ignorados. |
| `Authorization` | cabeçalho | sim | `Bearer pf_live_...` |

Placas antigas e Mercosul são equivalentes: `INT8236` e `INT8C36` retornam o mesmo veículo.

## Exemplo

```bash
curl https://api.placaefipe.com.br/v1/placas/INT8C36 \
  -H "Authorization: Bearer $PLACAEFIPE_API_KEY"
```

## Resposta 200

```json
{
  "placa": "INT8C36",
  "placa_antiga": "INT8236",
  "marca": "VW",
  "modelo": "CROSSFOX",
  "versao": "CROSSFOX 1.6 Mi Total Flex 8V 5p",
  "ano_fabricacao": 2007,
  "ano_modelo": 2007,
  "cor": "Prata",
  "combustivel": "Alcool / Gasolina",
  "chassi_final": "10137",
  "municipio": "São Leopoldo",
  "uf": "RS",
  "situacao": "Sem restrição",
  "origem": "Nacional",
  "tecnico": {
    "motor": "1.6",
    "tipo": "Automovel",
    "especie": "Passageiro",
    "segmento": "AU - HATCH PEQUENO",
    "cilindradas": 1599,
    "passageiros": 5,
    "eixos": 2
  },
  "fipe": {
    "codigo": "005225-6",
    "marca": "VW - VolksWagen",
    "modelo": "CROSSFOX 1.6 Mi Total Flex 8V 5p",
    "ano_modelo": 2007,
    "combustivel": "Gasolina",
    "valor": 28799.0,
    "valor_texto": "R$ 28.799,00",
    "referencia": "novembro de 2026",
    "versoes": []
  },
  "consulta": {
    "id": "cns_7Hq2LmXa9P",
    "creditos_restantes": 989,
    "cobrada": true,
    "cache": false
  }
}
```

## Campos

| Campo | Tipo | Descrição |
|---|---|---|
| `placa` | string | Placa no padrão Mercosul |
| `placa_antiga` | string ou null | Placa no padrão antigo (quando existe) |
| `marca` | string ou null | Marca como registrada (ex.: `VW`, `FIAT`, `HONDA`) |
| `modelo` | string ou null | Modelo (ex.: `CROSSFOX`) |
| `versao` | string ou null | Versão mais provável (da FIPE) |
| `ano_fabricacao` | number ou null | Ano de fabricação |
| `ano_modelo` | number ou null | Ano do modelo |
| `cor` | string ou null | Cor predominante |
| `combustivel` | string ou null | Como consta no registro (ex.: `Alcool / Gasolina`) |
| `chassi_final` | string ou null | Últimos 5 caracteres do chassi |
| `municipio` | string ou null | Município de registro |
| `uf` | string ou null | Estado de registro (sigla) |
| `situacao` | string ou null | Situação do veículo (ex.: `Sem restrição`) |
| `origem` | string ou null | `Nacional` ou `Importado` |
| `tecnico.motor` | string ou null | Motorização em litros (ex.: `1.6`) |
| `tecnico.tipo` | string ou null | Automóvel, Motocicleta, Caminhonete… |
| `tecnico.especie` | string ou null | Passageiro, Carga, Misto… |
| `tecnico.segmento` | string ou null | Segmento de mercado |
| `tecnico.cilindradas` | number ou null | Cilindrada em cm³ |
| `tecnico.passageiros` | number ou null | Lotação |
| `tecnico.eixos` | number ou null | Número de eixos |
| `fipe` | object ou null | Tabela FIPE. Detalhes em [FIPE](/docs/fipe) |
| `consulta.id` | string | ID da consulta, para suporte |
| `consulta.creditos_restantes` | number | Saldo depois desta consulta |
| `consulta.cobrada` | boolean | Se esta consulta consumiu crédito |
| `consulta.cache` | boolean | Se veio do nosso cache (não muda o preço) |

Qualquer campo pode vir `null` quando o registro não tem a informação. **Trate todos como opcionais**, exceto `placa` e `consulta`.

## Cabeçalhos da resposta

| Cabeçalho | Exemplo | Descrição |
|---|---|---|
| `X-Creditos-Restantes` | `989` | Saldo depois da consulta |
| `X-Consulta-Id` | `cns_7Hq2LmXa9P` | Mesmo valor de `consulta.id` |

## Respostas de erro

| HTTP | `erro.codigo` | Cobra crédito? |
|---|---|---|
| 400 | `placa_invalida` | Não |
| 401 | `nao_autenticado` ou `chave_invalida` | Não |
| 402 | `sem_creditos` | Não |
| 404 | `placa_nao_encontrada` | **Não** |
| 429 | `limite_excedido` | Não |
| 503 | `indisponivel` | Não |

Formato e tratamento em [Erros](/docs/erros).