Copy page

Documentação

Consultando a API

A API segue a estrutura hierárquica da tabela FIPE. Para chegar ao preço de um veículo, percorra os quatro níveis abaixo, nesta ordem:

Marca → Modelo → Ano → Preço

Todos os exemplos usam a URL base https://fipe.parallelum.com.br/api/v2 e o tipo cars. O parâmetro de tipo de veículo (vehicleType) aceita cars, motorcycles e trucks.

Passo 1 — Marcas

Liste as marcas disponíveis para o tipo de veículo.

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

Code
[
  { "code": "1", "name": "Acura" },
  { "code": "25", "name": "Honda" },
  { "code": "59", "name": "VW - VolksWagen" }
]

Próximo passo: use o code da marca para listar os modelos.

Passo 2 — Modelos

Com o código da marca, liste os modelos disponíveis. Exemplo: Honda = 25.

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

Code
[
  { "code": "1248", "name": "Civic Coupe EX/ EXS 1.6 16V 2p" },
  { "code": "7693", "name": "Civic Sedan EXL 2.0 Flex 16V Aut.4p" }
]

Próximo passo: use o code do modelo para listar os anos.

Passo 3 — Anos

Informe marca e modelo para listar os anos disponíveis.

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

Code
[
  { "code": "2021-5", "name": "2021 Flex" },
  { "code": "2020-5", "name": "2020 Flex" },
  { "code": "2019-5", "name": "2019 Flex" }
]

O código do ano combina o ano do modelo e o combustível: 2020-5 = 2020 Flex. A tabela completa de combustíveis está na Introdução.

Próximo passo: use o code do ano para obter o preço.

Passo 4 — Preço

Adicione o código do ano para obter o preço FIPE do veículo.

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"
}

A estrutura completa da URL é:

Code
/{vehicleType}/brands/{brandId}/models/{modelId}/years/{yearId}

Busca por código FIPE

Se você já possui o código FIPE do veículo, consulte diretamente, sem percorrer os quatro passos anteriores.

Para listar os anos disponíveis do código:

Code
curl https://fipe.parallelum.com.br/api/v2/cars/014090-2/years

Code
[
  { "code": "2021-5", "name": "2021 Flex" },
  { "code": "2020-5", "name": "2020 Flex" },
  { "code": "2019-5", "name": "2019 Flex" }
]

Para obter o preço de um ano específico:

Code
curl https://fipe.parallelum.com.br/api/v2/cars/014090-2/years/2020-5

A resposta é idêntica à do Passo 4.

Fluxo alternativo — Marca → Ano → Modelo

Além do fluxo tradicional, a API permite selecionar primeiro a marca e o ano, e só então listar os modelos. Útil quando o usuário conhece o ano do veículo antes do modelo — em formulários de cotação, por exemplo.

A — Anos disponíveis da marca

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

Code
[
  { "code": "32000-1", "name": "32000 Gasolina" },
  { "code": "32000-5", "name": "32000 Flex" },
  { "code": "2027-3", "name": "2027 Diesel" }
]

O ano 32000 identifica veículos zero KM.

B — Modelos por marca e ano

Code
curl https://fipe.parallelum.com.br/api/v2/cars/brands/59/years/2014-3/models

Code
[
  { "code": "5586", "name": "AMAROK CD2.0 16V/S CD2.0 16V TDI 4x4 Die" },
  { "code": "5748", "name": "AMAROK CS2.0 16V/S2.0 16V TDI 4x2 Diesel" }
]

C — Preço

Com marca, modelo e ano definidos, consulte o preço pelo mesmo endpoint do fluxo tradicional: /cars/brands/{brandId}/models/{modelId}/years/{yearId}.

Histórico de preços

Consulte a variação de preço de um veículo ao longo dos meses — útil para gráficos de desvalorização, análises de mercado e relatórios de tendência. A consulta é feita por código FIPE:

Code
curl https://fipe.parallelum.com.br/api/v2/cars/014090-2/years/2020-5/history

Code
{
  "vehicleType": 1,
  "brand": "Honda",
  "model": "Civic Sedan EXL 2.0 Flex 16V Aut.4p",
  "modelYear": 2020,
  "fuel": "Flex",
  "codeFipe": "014090-2",
  "fuelAcronym": "F",
  "priceHistory": [
    { "price": "R$ 119.329,00", "month": "julho de 2026", "reference": "335" },
    { "price": "R$ 119.681,00", "month": "junho de 2026", "reference": "334" },
    { "price": "R$ 119.237,00", "month": "maio de 2026", "reference": "333" }
  ]
}

O retorno é ordenado do mês mais recente para o mais antigo. O plano gratuito retorna os últimos 3 meses; os planos Premium dão acesso a 1 ano de histórico.

Meses de referência

A FIPE publica uma tabela por mês. O endpoint /references lista os meses disponíveis e seus códigos:

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

Code
[
  { "code": "335", "month": "julho/2026" },
  { "code": "334", "month": "junho/2026" },
  { "code": "333", "month": "maio/2026" }
]

Para consultar os valores de um mês anterior, informe o código no parâmetro reference de qualquer consulta:

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

Próximos passos

• Guia JavaScript — as mesmas consultas com a biblioteca fipe-promise.
• Casos de uso práticos — aplicações da API em avaliação, comparação e financiamento de veículos.
• Referência da API — especificação completa de endpoints, parâmetros e schemas.