API FIPE

Documentação da API

Aprenda a autenticar e consumir os dados da FIPE REST API na sua aplicação. Todos os endpoints retornam JSON e exigem uma API Key. Acompanhe as últimas mudanças da API no Changelog.

Autenticação

Toda requisição precisa do header HTTP Authorization com sua API Key secreta, obtida no Painel do Desenvolvedor. O header x-api-key também é aceito.

curl "https://apifipe.com/api/v1/marcas" \
  -H "Authorization: Bearer SUA_API_KEY"

Códigos de Status

A API usa códigos de status HTTP padrão. Corpos de erro seguem o formato { "error": "mensagem" }.

200OKRequisição bem-sucedida; retorna os dados solicitados.
400Bad RequestParâmetro de path inválido (ex.: id não numérico).
401UnauthorizedHeader Authorization ausente.
403ForbiddenAPI Key inválida ou revogada.
500Server ErrorErro interno ao consultar os dados.

MCP Server

Além da API REST, os dados da FIPE estão disponíveis como um servidor MCP (Model Context Protocol), para que agentes de IA — como Claude, Cursor ou Windsurf — consultem marcas, modelos e preços diretamente como tools. O endpoint usa o transporte Streamable HTTP e a mesma API Key da API REST (header Authorization: Bearer).

MCPhttps://apifipe.com/api/mcp

Tools disponíveis

listar_tipos_veiculo
Lista os tipos de veículo (carros, motos, caminhões).args: —
listar_tabelas_referencia
Lista os meses de referência disponíveis.args: —
listar_marcas
Lista as marcas, com filtro opcional por tipo de veículo.args: tipo?
listar_modelos
Lista os modelos de uma marca.args: marca_id
listar_anos_modelo
Lista os anos e combustíveis de um modelo.args: modelo_id
consultar_precos_marca
Histórico de preços de todos os modelos de uma marca.args: marca_id, limite?, codigo_tabela_referencia?
consultar_precos_modelo
Histórico de preços das variações de um modelo.args: modelo_id, limite?
consultar_preco
Preço atual e histórico FIPE de um ano/modelo específico.args: id_ano_modelo

Conectar no Claude Code

claude mcp add --transport http fipe \
  https://apifipe.com/api/mcp \
  --header "Authorization: Bearer SUA_API_KEY"

Claude Desktop / clientes com Streamable HTTP

{
  "mcpServers": {
    "fipe": {
      "url": "https://apifipe.com/api/mcp",
      "headers": {
        "Authorization": "Bearer SUA_API_KEY"
      }
    }
  }
}

Clientes apenas stdio (via mcp-remote)

{
  "mcpServers": {
    "fipe": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://apifipe.com/api/mcp",
        "--header",
        "Authorization: Bearer SUA_API_KEY"
      ]
    }
  }
}

Endpoints

Referência completa da API REST. Todos os endpoints retornam JSON, exigem autenticação via API Key e têm como base a URL https://apifipe.com.

GET/api/v1/tipos-veiculo

Listar Tipos de Veículo

Retorna todos os tipos de veículos disponíveis na tabela FIPE (carros, motos, caminhões).

Requisição

curl -X GET "https://apifipe.com/api/v1/tipos-veiculo" \
  -H "Authorization: Bearer SUA_API_KEY"

Resposta

Sucesso

[
  { "id": 1, "tipo": "carros e utilitarios pequenos" },
  { "id": 2, "tipo": "motos" },
  { "id": 3, "tipo": "caminhoes e micro-onibus" }
]
GET/api/v1/tabelas-referencia

Listar Tabelas de Referência

Retorna os meses de referência para os quais existem dados de preço disponíveis.

Requisição

curl -X GET "https://apifipe.com/api/v1/tabelas-referencia" \
  -H "Authorization: Bearer SUA_API_KEY"

Resposta

Sucesso

[
  { "id": 334, "tabela_referencia": "junho/2026" }
]
GET/api/v1/marcas

Listar Marcas

Retorna a lista de todas as marcas de veículos. Pode-se filtrar por tipo de veículo usando o parâmetro 'tipo'.

Parâmetros

tipoqueryopcional

Código do tipo de veículo (ex.: 1 = Carros, 2 = Motos).

Requisição

curl -X GET "https://apifipe.com/api/v1/marcas?tipo=1" \
  -H "Authorization: Bearer SUA_API_KEY"

Resposta

Sucesso

[
  { "id": 1, "marca": "Acura" }
]
GET/api/v1/marcas/{id}/modelos

Listar Modelos de uma Marca

Retorna todos os modelos de veículos associados ao ID da marca especificada.

Parâmetros

idpathobrigatório

ID único da marca no banco de dados.

Requisição

curl -X GET "https://apifipe.com/api/v1/marcas/1/modelos" \
  -H "Authorization: Bearer SUA_API_KEY"

Resposta

Sucesso

[
  { "id": 2, "modelo": "Integra GS 1.8" }
]
GET/api/v1/modelos/{id}/anos

Listar Anos de um Modelo

Retorna os anos de fabricação e tipos de combustível disponíveis para o modelo especificado.

Parâmetros

idpathobrigatório

ID único do modelo.

Requisição

curl -X GET "https://apifipe.com/api/v1/modelos/2/anos" \
  -H "Authorization: Bearer SUA_API_KEY"

Resposta

Sucesso

[
  { "id": 2, "ano_modelo": 1992, "ano_modelo_texto": "1992", "combustivel": "Gasolina" },
  { "id": 3, "ano_modelo": 32000, "ano_modelo_texto": "Zero Km", "combustivel": "Gasolina" }
]
GET/api/v1/marcas/{id}/precos

Consultar Preços por Marca

Retorna os preços de todos os modelos e anos de uma marca específica. Ordenado por mês de referência (mais recente primeiro) e, dentro do mês, por ano do modelo decrescente (0 km primeiro).

Parâmetros

idpathobrigatório

ID da marca.

limitequeryopcional

Itens por página (padrão e máximo: 100).

codigo_tabela_referenciaqueryopcional

Filtrar por um mês de referência específico.

cursorqueryopcional

Cursor da próxima página (campo proximo_cursor da resposta anterior).

Requisição

curl -X GET "https://apifipe.com/api/v1/marcas/1/precos?limite=10" \
  -H "Authorization: Bearer SUA_API_KEY"

Resposta

Sucesso

{
  "dados": [
    {
      "id": 3,
      "tabela_referencia": "junho/2026",
      "codigo_fipe": "038003-2",
      "valor": 10816,
      "valor_texto": "R$ 10.816,00",
      "marca": "Acura",
      "modelo": "Integra GS 1.8",
      "ano_modelo": 1992,
      "ano_modelo_texto": "1992",
      "combustivel": "Gasolina"
    }
  ],
  "proximo_cursor": "MzM0LjM"
}
GET/api/v1/modelos/{id}/precos

Consultar Preços por Modelo

Retorna os preços de todas as variações de ano e combustível de um modelo específico. Ordenado por mês de referência (mais recente primeiro) e, dentro do mês, por ano do modelo decrescente (0 km primeiro).

Parâmetros

idpathobrigatório

ID do modelo.

limitequeryopcional

Itens por página (padrão e máximo: 100).

codigo_tabela_referenciaqueryopcional

Filtrar por um mês de referência específico.

cursorqueryopcional

Cursor da próxima página (campo proximo_cursor da resposta anterior).

Requisição

curl -X GET "https://apifipe.com/api/v1/modelos/2/precos" \
  -H "Authorization: Bearer SUA_API_KEY"

Resposta

Sucesso

{
  "dados": [
    {
      "id": 4,
      "tabela_referencia": "junho/2026",
      "codigo_fipe": "038003-2",
      "valor": 24766,
      "valor_texto": "R$ 24.766,00",
      "marca": "Acura",
      "modelo": "Legend 3.2/3.5",
      "ano_modelo": 1998,
      "ano_modelo_texto": "1998",
      "combustivel": "Gasolina"
    }
  ],
  "proximo_cursor": "MzM0LjQ"
}
GET/api/v1/precos/{id_ano_modelo}

Consultar Preço Específico

Retorna o preço atual e o histórico de avaliações FIPE de um veículo para o ano/combustível.

Parâmetros

id_ano_modelopathobrigatório

ID da combinação modelo+ano (model_year_id).

Requisição

curl -X GET "https://apifipe.com/api/v1/precos/5000" \
  -H "Authorization: Bearer SUA_API_KEY"

Resposta

Sucesso

[
  {
    "id": 5000,
    "tabela_referencia": "junho/2026",
    "codigo_fipe": "038001-6",
    "valor": 39978,
    "valor_texto": "R$ 39.978,00",
    "marca": "Acura",
    "modelo": "NSX 3.0",
    "ano_modelo": 1995,
    "ano_modelo_texto": "1995",
    "combustivel": "Gasolina"
  }
]