Documentação da API — Preço FIPE (JSON, aberta, sem chave)

Visão geral

Como funciona

Sem cadastro, sem chave, sem limite prático de uso razoável. Toda resposta é JSON UTF-8 com Access-Control-Allow-Origin: * e cache de 1 hora.

Base URL
https://precofipe.com
Autenticação
Nenhuma — endpoints abertos
Formato
JSON (application/json)
CORS
Liberado (*)
Cache
max-age=3600
Licença
Uso livre com atribuição

Endpoint

Buscar veículos

Filtra a base por marca, modelo e/ou tipo. Informe ao menos um filtro.

GET/v1/veiculos

Parâmetro	Tipo		Descrição
`marca`	string	opcional*	marca do veículo (busca parcial). Ex.: `fiat`
`modelo`	string	opcional*	modelo (busca parcial). Ex.: `uno`
`tipo`	enum	opcional*	`carro` · `moto` · `caminhao`
`limit`	inteiro	opcional	máx. de resultados (padrão 20, teto 100)

* informe ao menos um de marca, modelo ou tipo — sem filtro a resposta é 400.

Requisição

curl -s "https://precofipe.com/v1/veiculos?marca=honda&modelo=civic"

Resposta (abreviada a 1 resultado)

{
  "fonte": "Tabela FIPE",
  "total": 1,
  "limite": 20,
  "resultados": [
    {
      "codigo_fipe": "014003-1",
      "tipo": "carro",
      "marca": "Honda",
      "modelo": "Civic Sedan EX/ EXS Aut. 4p/ Del-Sol 2p",
      "anos": {
        "min": 1992,
        "max": 1997
      },
      "preco": {
        "min": 11210.0,
        "max": 18746.0,
        "moeda": "BRL"
      },
      "mes_referencia": "outubro de 2026",
      "url": "https://precofipe.com/veiculo/honda-civic-sedan-ex-exs-aut-4p-del-sol-2p-014003-1",
      "detalhe_api": "https://precofipe.com/v1/veiculos/014003-1"
    }
  ]
}

Endpoint

Detalhe por código FIPE

Todos os preços de um modelo, por ano-modelo e combustível. O código FIPE é o identificador oficial e estável para citar e cruzar dados.

GET/v1/veiculos/{codigo}

Parâmetro	Tipo		Descrição
`codigo`	string (path)	obrigatório	código FIPE. Ex.: `014003-1`

Requisição

curl -s "https://precofipe.com/v1/veiculos/014003-1"

Resposta

{
  "fonte": "Tabela FIPE",
  "codigo_fipe": "014003-1",
  "tipo": "carro",
  "marca": "Honda",
  "modelo": "Civic Sedan EX/ EXS Aut. 4p/ Del-Sol 2p",
  "mes_referencia": "outubro de 2026",
  "faixa_preco": {
    "min": 11210.0,
    "max": 18746.0,
    "moeda": "BRL"
  },
  "precos": [
    {
      "ano_modelo": 1997,
      "combustivel": "Gasolina",
      "sigla": "G",
      "valor": 18746.0,
      "valor_formatado": "R$ 18.746,00",
      "moeda": "BRL"
    },
    {
      "ano_modelo": 1996,
      "combustivel": "Gasolina",
      "sigla": "G",
      "valor": 18288.0,
      "valor_formatado": "R$ 18.288,00",
      "moeda": "BRL"
    },
    {
      "ano_modelo": 1995,
      "combustivel": "Gasolina",
      "sigla": "G",
      "valor": 17841.0,
      "valor_formatado": "R$ 17.841,00",
      "moeda": "BRL"
    },
    {
      "ano_modelo": 1994,
      "combustivel": "Gasolina",
      "sigla": "G",
      "valor": 15583.0,
      "valor_formatado": "R$ 15.583,00",
      "moeda": "BRL"
    }
  ],
  "url": "https://precofipe.com/veiculo/honda-civic-sedan-ex-exs-aut-4p-del-sol-2p-014003-1"
}

Erros

Respostas de erro

Erros também são JSON e trazem uma dica para acertar a chamada.

400 — nenhum filtro na busca

{
  "erro": "informe ?marca=, ?modelo= ou ?tipo= (carro|moto|caminhao)",
  "exemplos": [
    "/v1/veiculos?marca=fiat",
    "/v1/veiculos?marca=honda&modelo=civic"
  ]
}

404 — código FIPE inexistente

{
  "erro": "código FIPE não encontrado",
  "codigo": "000000-0",
  "dica": "use /v1/veiculos?marca=... para descobrir o código"
}

Referência

Campos da resposta

Campo	Descrição
`codigo_fipe`	identificador oficial FIPE (chave estável para citar)
`tipo`	`carro` · `moto` · `caminhao`
`marca` · `modelo`	texto conforme a Tabela FIPE
`anos.min` · `anos.max`	faixa de anos-modelo disponíveis
`preco.min` · `preco.max` · `faixa_preco`	faixa de preço no mês, em reais (número)
`mes_referencia`	mês da tabela FIPE (ex.: outubro de 2026)
`precos[].ano_modelo`	ano-modelo, ou `"zero_km"` para 0 km
`precos[].combustivel` · `sigla`	combustível e sua sigla (G, D, F…)
`precos[].valor` · `valor_formatado`	preço em número e em texto BRL