#01 / overview

Documentação da API

REST sobre HTTPS, respostas JSON, autenticação por Bearer token. Estrutura hierárquica de URLs (tipo → marca → modelo → ano) e schema OpenAPI 3 publicado em /docs.

Base URL

Produção: https://api.fipe.altis.online

Documentação OpenAPI: /docs

Tipos de veículos

cars → carros e utilitários pequenos (vehicleType=1)
motorcycles → motos (vehicleType=2)
trucks → caminhões e micro-ônibus (vehicleType=3)

#02 / auth

Autenticação

Gere chaves no painel. O prefixo é fpk_live_ e o segredo é exibido apenas uma vez. Armazenamos somente o hash SHA-256.

# Recomendado
Authorization: Bearer fpk_live_xxx

# Alternativo (compatível com SDKs antigos)
X-Subscription-Token: fpk_live_xxx

#03 / endpoints

Endpoints

Método	Path	Créditos	Descrição
GET	/api/v2/references	0	Lista referências de meses disponíveis (apenas o mês corrente em v1).
GET	/api/v2/{vehicleType}/brands	0	Marcas para `cars`, `motorcycles` ou `trucks`.
GET	/api/v2/{vehicleType}/brands/{brandId}/models	1	Modelos para a marca informada.
GET	/api/v2/{vehicleType}/brands/{brandId}/models/{modelId}/years	1	Anos e combustíveis disponíveis para o modelo.
GET	/api/v2/{vehicleType}/brands/{brandId}/models/{modelId}/years/{yearId}	2	Preço FIPE atual + metadados.
GET	/api/v2/{vehicleType}/brands/{brandId}/years	1	Anos distintos disponíveis para a marca.
GET	/api/v2/{vehicleType}/brands/{brandId}/years/{yearId}/models	1	Modelos filtrados por marca + ano.

#04 / example

Exemplo: preço FIPE

GET /api/v2/cars/brands/56/models/9984/years/2025-6

{
  "brand": "Toyota",
  "codeFipe": "002182-2",
  "fuel": "Híbrido",
  "fuelAcronym": "H",
  "model": "Corolla Altis 1.8 16V Aut. (Híbrido)",
  "modelYear": 2025,
  "price": "R$ 195.328,00",
  "priceHistory": [],
  "referenceMonth": "abril de 2026",
  "vehicleType": 1
}

#05 / errors

Erros

Status	Code	Descrição
401	MISSING_API_KEY	Header de chave ausente.
401	INVALID_API_KEY	Chave inválida ou revogada.
402	INSUFFICIENT_CREDITS	Saldo zerado. Compre mais créditos no painel.
404	BRAND_NOT_FOUND	Marca inexistente para o tipo.
429	RATE_LIMIT_EXCEEDED	Acima de 60 req/min na chave. Solicite aumento.
502	UPSTREAM_REQUEST_FAILED	Falha temporária no provedor FIPE.