Documentação

Guia completo para integrar a API Fipe no seu projeto.

Sobre

A API Fipe expressa preços médios de veículos anunciados pelos vendedores no mercado nacional, servindo como um parâmetro para negociações ou avaliações. Os dados são atualizados mensalmente (entre os dias 01 e 03 de cada mês).

Autenticação

Todas as requisições exigem autenticação via header Authorization usando o padrão Bearer Token.

Seu token é gerado automaticamente após a confirmação de pagamento do Plano. Ele fica disponível no seu Painel.

Header obrigatório em todas as requisições:

Authorization: Bearer SEU_TOKEN

⚠️ Nunca compartilhe seu token publicamente ou exponha no front-end. Use-o apenas em requisições server-side.

Início rápido

A API segue uma estrutura hierárquica simples. Para consultar o preço de um veículo, siga os 4 passos abaixo em ordem:

1Marcas

Liste as marcas disponíveis

/carros

2Modelos

Escolha o modelo da marca

/carros/7

3Anos

Veja os anos do modelo

/carros/7/8946

4Valor

Obtenha o preço FIPE

/carros/7/8946/2021-1

💡 Atalho: Se você já tem o código FIPE do veículo, pode pular direto para a busca por código FIPE sem precisar seguir os passos acima.

Marcas

Comece listando as marcas de um tipo de veículo. Os tipos disponíveis são: carros, motos e caminhoes.

GET https://api.apifipe.com.br/carros

json

[
  {
    "codMarca": 1,
    "nomeMarca": "Acura",
    "tipoVeiculo": 1
  },
  {
    "codMarca": 2,
    "nomeMarca": "Agrale",
    "tipoVeiculo": 1
  }
]

Próximo passo: use o codMarca para listar os modelos.

Modelos

Com o codMarca obtido no passo anterior, liste os modelos disponíveis. Ex: BMW = 7

GET https://api.apifipe.com.br/carros/7

json

[
  {
    "codModelo": "6146",
    "codMarca": 7,
    "nomeModelo": "116iA 1.6 TB 16V 136cv 5p",
    "refFipe": 286,
    "tipoVeiculo": 1
  },
  {
    "codModelo": "8946",
    "codMarca": 7,
    "nomeModelo": "118i Sport 1.5 TB 12V Aut. 5p",
    "refFipe": 286,
    "tipoVeiculo": 1
  }
]

Próximo passo: use o codModelo para listar os anos.

Anos

Informe codMarca e codModelo para listar os anos disponíveis.

GET https://api.apifipe.com.br/carros/7/8946

json

[
  {
    "codModelo": 8946,
    "codMarca": 7,
    "tipoVeiculo": 1,
    "refFipe": "286",
    "nomeAno": "32000 Gasolina",
    "codAno": "32000-1"
  },
  {
    "codModelo": 8946,
    "codMarca": 7,
    "tipoVeiculo": 1,
    "refFipe": "286",
    "nomeAno": "2022 Gasolina",
    "codAno": "2022-1"
  }
]

Próximo passo: use o codAno para obter o preço.

Valor

Último passo! Adicione o codAno para obter o preço FIPE do veículo.

GET https://api.apifipe.com.br/carros/7/8946/2021-1

json

{
  "codModelo": "8946",
  "codMarca": 7,
  "tipoCombustivel": "Gasolina",
  "nomeModelo": "118i Sport 1.5 TB 12V Aut. 5p",
  "siglaCombustivel": "G",
  "codFipe": "009258-4",
  "refFipe": 286,
  "nomeMarca": "BMW",
  "refMes": "junho de 2022",
  "valorVeiculo": "R$ 228.091,00",
  "anoModelo": "2021",
  "tipoVeiculo": 1
}

✅ Pronto! Você obteve o preço FIPE do veículo. A estrutura completa da URL é: /{tipo}/{codMarca}/{codModelo}/{codAno}

Busca por Código Fipe

Se você já possui o código FIPE do veículo, pode consultar diretamente sem percorrer os 4 passos anteriores. Retorna todos os anos disponíveis para aquele código.

GET https://api.apifipe.com.br/fipe/009258-4

json

[
  {
    "codModelo": "8946",
    "codMarca": 7,
    "tipoCombustivel": "Gasolina",
    "nomeModelo": "118i Sport 1.5 TB 12V Aut. 5p",
    "siglaCombustivel": "G",
    "codFipe": "009258-4",
    "refFipe": 286,
    "nomeMarca": "BMW",
    "refMes": "junho de 2022",
    "valorVeiculo": "R$ 289.928,00",
    "anoModelo": "32000",
    "tipoVeiculo": 1
  }
]

Código Fipe + Ano

Para obter o preço de um ano específico usando o código FIPE:

GET https://api.apifipe.com.br/fipe/009258-4/2021-1

json

{
  "codModelo": "8946",
  "codMarca": 7,
  "tipoCombustivel": "Gasolina",
  "nomeModelo": "118i Sport 1.5 TB 12V Aut. 5p",
  "siglaCombustivel": "G",
  "codFipe": "009258-4",
  "refFipe": 286,
  "nomeMarca": "BMW",
  "refMes": "junho de 2022",
  "valorVeiculo": "R$ 228.091,00",
  "anoModelo": "2021",
  "tipoVeiculo": 1
}

Referência

Informações complementares sobre parâmetros e convenções da API.

Estrutura da URL

https://api.apifipe.com.br/tipo/codMarca/codModelo/codAno

O parâmetro tipo aceita: carros, motos, caminhoes ou fipe (para busca direta por código FIPE).

Parâmetro codAno

Composto pela junção do ano de fabricação + código do combustível, separados por hífen.

1Gasolina

2Álcool

3Diesel

4Elétrico

5Flex

6Híbrido

Exemplo: 2012-1 = ano 2012, combustível Gasolina. Existe mais de um combustível por ano em alguns veículos, por isso o codAno inclui essa informação.

Convenções

⚠️ Veículo com ano 32000 é referente a um veículo 0 Km.
📅 Os dados são atualizados mensalmente entre os dias 01 e 03 de cada mês.
🔑 Todas as requisições exigem o header Authorization: Bearer TOKEN.
📡 O método utilizado é sempre GET.

Exemplos de uso

Veja como consumir a API em diferentes linguagens. Substitua SEU_TOKEN pelo seu token real.

Usando fetch (Node.js / Browser):

javascript

const TOKEN = "SEU_TOKEN";
const BASE = "https://api.apifipe.com.br";

// Listar marcas de carros
const res = await fetch(`${BASE}/carros`, {
  headers: { "Authorization": `Bearer ${TOKEN}` }
});
const marcas = await res.json();
console.log(marcas);

// Buscar valor de um veículo
const valor = await fetch(`${BASE}/carros/7/8946/2021-1`, {
  headers: { "Authorization": `Bearer ${TOKEN}` }
});
const dados = await valor.json();
console.log(dados.valorVeiculo); // "R$ 228.091,00"

Códigos de retorno

Código	Descrição
200	Retorno com sucesso.
400	URL incorreta ou parâmetros inválidos.
401	Token inválido ou ausente.
402	Assinatura inativa ou expirada.
403	Conta bloqueada.
406	Sem resultados para os parâmetros informados.
429	Limite de consultas diárias atingido.
500	Erro no servidor.

Todos os códigos de erro retornam com uma mensagem detalhando o erro:

json

{
  "mensagem": "Token de autenticação não fornecido. Use o header 'Authorization: Bearer SEU_TOKEN'. Cod.(7007)"
}