Copy page

Documentação

Introdução

A FIPE API fornece os preços médios de veículos praticados no mercado brasileiro, extraídos da tabela FIPE (Fundação Instituto de Pesquisas Econômicas). Os valores servem como parâmetro para negociações, avaliações e análises de mercado e são atualizados mensalmente, no início de cada mês.

A API opera sobre banco de dados próprio: as consultas não passam pelo Web Service da FIPE, o que garante tempos de resposta baixos e elimina bloqueios por excesso de acessos. Em operação desde 2015, atende aplicações de concessionárias, seguradoras, financeiras e marketplaces com dados de carros, motos e caminhões.

Visão geral

• URL base: https://fipe.parallelum.com.br/api/v2
• Método: todas as operações usam GET
• Formato de resposta: JSON
• Autenticação: opcional, via header X-Subscription-Token
• Atualização dos dados: mensal, no início de cada mês

Recursos

• Consulta hierárquica — navegue por marca, modelo e ano até chegar ao preço.
• Busca por código FIPE — consulte o preço diretamente, sem percorrer a hierarquia.
• Fluxo alternativo por ano — selecione marca e ano antes de listar os modelos.
• Histórico de preços — acompanhe a variação de valor por mês de referência.
• Tabelas de referência — consulte os dados de meses anteriores.

Primeira consulta

Não é necessário cadastro para começar. A requisição abaixo lista as marcas de carros:

Code
curl https://fipe.parallelum.com.br/api/v2/cars/brands

Code
[
  { "code": "1", "name": "Acura" },
  { "code": "2", "name": "Agrale" },
  { "code": "3", "name": "Alfa Romeo" }
]

Para obter o preço de um veículo, informe marca, modelo e ano:

Code
curl https://fipe.parallelum.com.br/api/v2/cars/brands/25/models/7693/years/2020-5

Code
{
  "vehicleType": 1,
  "price": "R$ 119.329,00",
  "brand": "Honda",
  "model": "Civic Sedan EXL 2.0 Flex 16V Aut.4p",
  "modelYear": 2020,
  "fuel": "Flex",
  "codeFipe": "014090-2",
  "referenceMonth": "julho de 2026",
  "fuelAcronym": "F"
}

O passo a passo completo de cada consulta, incluindo a busca direta por código FIPE, está em Consultando a API.

Autenticação e limites

A API pode ser usada sem autenticação, com limite de 500 requisições por dia. Para elevar o limite, informe seu token no header X-Subscription-Token em todas as requisições:

Code
curl -H "X-Subscription-Token: SEU_TOKEN" \
  https://fipe.parallelum.com.br/api/v2/cars/brands

Plano	Limite de requisições	Como obter
Sem autenticação	500 por dia (24h)	—
Token gratuito	1.000 por dia (24h)	Cadastro em fipe.api.br
Premium	Ilimitado	Planos em fipe.api.br

Os planos Premium incluem também 1 ano de histórico de preços e download completo da base em CSV.

Convenções

Código do ano

O identificador de ano (yearId) combina o ano do modelo e o código do combustível, separados por hífen. Exemplo: 2020-5 = modelo 2020, combustível Flex.

Código	Combustível
1	Gasolina
2	Álcool
3	Diesel
4	Elétrico
5	Flex
6	Híbrido

Um mesmo modelo pode ter mais de uma versão de combustível no mesmo ano — por isso o identificador carrega as duas informações.

Veículo zero-quilômetro

O ano 32000 identifica veículos zero KM na base FIPE. Exemplo: 32000-5 = veículo novo, combustível Flex.

Mês de referência

A FIPE publica uma tabela por mês. Por padrão, as consultas retornam os valores do mês vigente; para consultar um mês anterior, informe o parâmetro de query reference com o código do mês desejado, obtido no endpoint /references.

Códigos de retorno

Código	Descrição
200	Consulta realizada com sucesso.
401	Token informado no header X-Subscription-Token inválido ou expirado.
404	Recurso não encontrado — a combinação informada não existe na base FIPE.
429	Limite diário de requisições atingido.
500	Erro interno do servidor.

As respostas de erro incluem uma mensagem descrevendo o problema:

Code
{
  "error": "veículo não encontrado para a referência informada"
}

Código aberto e suporte

A API mantém uma opção gratuita para a comunidade de desenvolvedores desde 2015. O código está disponível no GitHub; planos, cadastro de token e contato em fipe.api.br.

Próximos passos

• Consultando a API — passo a passo das consultas por hierarquia, por código FIPE e do histórico de preços.
• Guia JavaScript — integração com a biblioteca fipe-promise.
• Referência da API — especificação completa de endpoints, parâmetros e schemas.