Ver .md Abrir no Claude Abrir no ChatGPT

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

Consultar placa

#Parâmetros

#Exemplo

#Resposta 200

#Campos

#Cabeçalhos da resposta