• Início
  • Endpoints
Overview

#Tabela Fipe API

API atualizada para consultar os preços médios dos carros, motos e caminhões do Brasil pela tabela FIPE

#Obter tipos de veículos

Obtém a lista de tipos de veículos disponíveis (ex.: carros, motos, caminhões)

#Headers

  • X-Api-Keyrequiredstring

    Chave de API gerada ao criar conta no Tabela Fipe API

#Responses

    object[]
    • idstring
    • namestring

#Obter marcas para um tipo específico

Obtém uma lista de marcas para o tipo de veículo especificado

#path Parameters

  • typeIdrequiredstring

#Headers

  • X-Api-Keyrequiredstring

    Chave de API gerada ao criar conta no Tabela Fipe API

#Responses

    object[]
    • idstring
    • namestring
    • typeobject

#Obter modelos para uma marca e tipo específicos

Obtém uma lista de modelos para a marca e tipo especificados

#path Parameters

  • typeIdrequiredstring
  • brandIdrequiredstring

#Headers

  • X-Api-Keyrequiredstring

    Chave de API gerada ao criar conta no Tabela Fipe API

#Responses

    object[]
    • brandobject
    • idstring
    • namestring
    • typeobject

#Obter anos disponíveis para um modelo, marca e tipo específicos

Obtém uma lista de anos disponíveis para o modelo, marca e tipo especificados

#path Parameters

  • typeIdrequiredstring
  • brandIdrequiredstring
  • modelIdrequiredstring

#Headers

  • X-Api-Keyrequiredstring

    Chave de API gerada ao criar conta no Tabela Fipe API

#Responses

    object[]
    • brandobject
    • fuelstring
    • idstring
    • modelobject
    • typeobject
    • yearstring

#Obter o preço para um ano, modelo, marca e tipo específicos

Obtém o preço para o ano, modelo, marca e tipo especificados

#path Parameters

  • typeIdrequiredstring
  • brandIdrequiredstring
  • modelIdrequiredstring
  • yearIdrequiredstring

#Headers

  • X-Api-Keyrequiredstring

    Chave de API gerada ao criar conta no Tabela Fipe API

#Responses

    • brandobject
    • idstring
    • modelobject
    • pricenumber
    • typeobject
    • yearobject

#Buscar veículos por similaridade para um tipo

Busca veículos por texto livre restringindo os resultados ao tipo informado. Quando period não é informado, usa o período mais recente disponível.

#path Parameters

  • typeIdrequiredstring

#query Parameters

  • qrequiredstring

    Texto livre do veículo

  • periodstring

    Período de referência da tabela FIPE. Se omitido, usa o período mais recente disponível.

  • limitnumber
  • minScorenumber
  • yearstring
  • fuelstring

#Headers

  • X-Api-Keyrequiredstring

    Chave de API gerada ao criar conta no Tabela Fipe API

#Responses

    • isLatestPeriodboolean

      Indica se a busca usou o período mais recente disponível

    • periodIdstring

      Período interno da FIPE usado na busca

    • querystring
    • resultsobject[]
    • typenumberoptional

      Tipo de veículo quando a busca foi filtrada por tipo

#Buscar veículos por similaridade

Busca veículos por texto livre em carros, motos e caminhões. Quando period não é informado, usa o período mais recente disponível.

#query Parameters

  • qrequiredstring

    Texto livre do veículo

  • periodstring

    Período de referência da tabela FIPE. Se omitido, usa o período mais recente disponível.

  • limitnumber
  • minScorenumber
  • yearstring
  • fuelstring

#Headers

  • X-Api-Keyrequiredstring

    Chave de API gerada ao criar conta no Tabela Fipe API

#Responses

    • isLatestPeriodboolean

      Indica se a busca usou o período mais recente disponível

    • periodIdstring

      Período interno da FIPE usado na busca

    • querystring
    • resultsobject[]
    • typenumberoptional

      Tipo de veículo quando a busca foi filtrada por tipo

Overview
Other endpoints
    Obter tipos de veículosgetObter marcas para um tipo específicogetObter modelos para uma marca e tipo específicosgetObter anos disponíveis para um modelo, marca e tipo específicosgetObter o preço para um ano, modelo, marca e tipo específicosgetBuscar veículos por similaridade para um tipogetBuscar veículos por similaridadeget
Endpoint:https://fipe.dev/v1
GET /types
curl --request GET \
  --url https://fipe.dev/v1/types
Show example in
Example Responses
[
  {
    "id": "1",
    "name": "Carros e Utilitários"
  },
  {
    "id": "2",
    "name": "Caminhões e Micro-ônibus"
  },
  {
    "id": "3",
    "name": "Motos"
  }
]
Resposta bem-sucedida
GET /types/{typeId}/brands
curl --request GET \
  --url https://fipe.dev/v1/types/:typeId/brands
Show example in
Example Responses
[
  {
    "id": "20",
    "name": "Ferrari",
    "type": {
      "id": "1",
      "name": "Carros e Utilitários"
    }
  },
  {
    "id": "22",
    "name": "Ford",
    "type": {
      "id": "1",
      "name": "Carros e Utilitários"
    }
  },
  {
    "id": "23",
    "name": "GM - Chevrolet",
    "type": {
      "id": "1",
      "name": "Carros e Utilitários"
    }
  }
]
Resposta bem-sucedida
GET /types/{typeId}/brands/{brandId}/models
curl --request GET \
  --url https://fipe.dev/v1/types/:typeId/brands/:brandId/models
Show example in
Example Responses
[
  {
    "brand": {
      "id": "20",
      "name": "Ferrari"
    },
    "id": "1",
    "name": "Ferrari 812 Superfast",
    "type": {
      "id": "1",
      "name": "Carros e Utilitários"
    }
  },
  {
    "brand": {
      "id": "20",
      "name": "Ferrari"
    },
    "id": "2",
    "name": "Ferrari 488 Pista",
    "type": {
      "id": "1",
      "name": "Carros e Utilitários"
    }
  },
  {
    "brand": {
      "id": "20",
      "name": "Ferrari"
    },
    "id": "3",
    "name": "Ferrari Portofino",
    "type": {
      "id": "1",
      "name": "Carros e Utilitários"
    }
  }
]
Resposta bem-sucedida
GET /types/{typeId}/brands/{brandId}/models/{modelId}/years
curl --request GET \
  --url https://fipe.dev/v1/types/:typeId/brands/:brandId/models/:modelId/years
Show example in
Example Responses
[
  {
    "brand": {
      "id": "20",
      "name": "Ferrari"
    },
    "fuel": "Gasolina",
    "id": "1",
    "model": {
      "id": "1",
      "name": "Ferrari 812 Superfast"
    },
    "type": {
      "id": "1",
      "name": "Carros e Utilitários"
    },
    "year": "2022"
  },
  {
    "brand": {
      "id": "20",
      "name": "Ferrari"
    },
    "fuel": "Gasolina",
    "id": "2",
    "model": {
      "id": "1",
      "name": "Ferrari 812 Superfast"
    },
    "type": {
      "id": "1",
      "name": "Carros e Utilitários"
    },
    "year": "2021"
  },
  {
    "brand": {
      "id": "20",
      "name": "Ferrari"
    },
    "fuel": "Gasolina",
    "id": "3",
    "model": {
      "id": "1",
      "name": "Ferrari 812 Superfast"
    },
    "type": {
      "id": "1",
      "name": "Carros e Utilitários"
    },
    "year": "2020"
  }
]
Resposta bem-sucedida
GET /types/{typeId}/brands/{brandId}/models/{modelId}/years/{yearId}
curl --request GET \
  --url https://fipe.dev/v1/types/:typeId/brands/:brandId/models/:modelId/years/:yearId
Show example in
Example Responses
{
  "brand": {
    "id": "20",
    "name": "Ferrari"
  },
  "id": "1",
  "model": {
    "id": "1",
    "name": "Ferrari 812 Superfast"
  },
  "price": 845000,
  "type": {
    "id": "1",
    "name": "Carros e Utilitários"
  },
  "year": {
    "fuel": "Gasolina",
    "id": "1",
    "year": "2022"
  }
}
Resposta bem-sucedida
GET /types/{typeId}/vehicles/search
curl --request GET \
  --url https://fipe.dev/v1/types/:typeId/vehicles/search
Show example in
Example Responses
{
  "isLatestPeriod": true,
  "periodId": "335",
  "query": "Audi TT roadster 2022",
  "results": [
    {
      "ambiguous": false,
      "brand": {
        "id": "6",
        "name": "Audi"
      },
      "confidence": "high",
      "matchedOn": [
        "brand",
        "model_tokens",
        "year"
      ],
      "model": {
        "id": "1234",
        "name": "TT Roadster 2.0 TB 16V TFSI Aut."
      },
      "price": {
        "fipeCode": "008180-0",
        "fuel": "Gasolina",
        "id": "008180-0",
        "price": 350000,
        "type": 1
      },
      "score": 94.2,
      "type": 1,
      "year": {
        "fuel": "Gasolina",
        "id": "2022-1",
        "year": "2022"
      }
    }
  ]
}
Resposta bem-sucedida
GET /vehicles/search
curl --request GET \
  --url https://fipe.dev/v1/vehicles/search
Show example in
Example Responses
{
  "isLatestPeriod": true,
  "periodId": "335",
  "query": "Audi TT roadster 2022",
  "results": [
    {
      "ambiguous": false,
      "brand": {
        "id": "6",
        "name": "Audi"
      },
      "confidence": "high",
      "matchedOn": [
        "brand",
        "model_tokens",
        "year"
      ],
      "model": {
        "id": "1234",
        "name": "TT Roadster 2.0 TB 16V TFSI Aut."
      },
      "price": {
        "fipeCode": "008180-0",
        "fuel": "Gasolina",
        "id": "008180-0",
        "price": 350000,
        "type": 1
      },
      "score": 94.2,
      "type": 1,
      "year": {
        "fuel": "Gasolina",
        "id": "2022-1",
        "year": "2022"
      }
    }
  ]
}
Resposta bem-sucedida