Hubs

Versões de uma família em um ano-modelo

Hub família-ano: todas as versões × combustível da família naquele ano-modelo, com código FIPE, preço atual e variação mês a mês. Ano sem versões retorna 404; ano mal formado retorna 400.

versions inclui as versões defasadas, cada uma com o seu ref_year/ref_month; já price e o ref_year/ref_month do hub vêm só das versões com preço no período mais recente do ano-modelo (mais antigo que o da tabela quando o ano inteiro está defasado).

get/v1/brands/{brand}/families/{family}/years/{year}

Request

  • Base URL: https://api.fipex.com.br
  • URL: https://api.fipex.com.br/v1/brands/{brand}/families/{family}/years/{year}
  • Auth: none declared

Path parameters

brandstring required

Slug da marca (fiat) ou slug real de uma das marcas FIPE que ela une (fiat-21). Compare brand.slug da resposta com o pedido para redirecionar para a URL canônica.

familystring required

Slug da família, único dentro da marca.

yearstring required

Ano-modelo com quatro dígitos (2020) ou zero para 0km. Outras grafias (+2020, 02020) respondem 400.

Response

Hub família-ano.

Example response

{
  "data": {
    "brand": {
      "slug": "fiat",
      "name": "Fiat",
      "vehicle_types": [
        "caminhão",
        "carro"
      ],
      "family_count": 38,
      "version_count": 590,
      "make_slugs": [
        "fiat",
        "fiat-21"
      ]
    },
    "family_slug": "onix",
    "family_name": "Onix",
    "year": {
      "value": "2020"
    },
    "versions": [
      {
        "model_name": "ONIX HATCH 1.0 12V Flex 5p Mecânico",
        "make_slug": "gm-chevrolet",
        "model_slug": "onix-hatch-1-0-12v-flex-5p-mec",
        "fuel_acronym": "f",
        "fuel_name": "Flex",
        "fipe_code": "004519-5",
        "vehicle_type": "carro",
        "price_cents": 5433000,
        "formatted_price": "R$ 54.330,00",
        "change_from_previous_month_pct": -0.0052,
        "ref_year": 2026,
        "ref_month": 10
      }
    ],
    "price": {
      "min_cents": 218100,
      "min_formatted": "R$ 2.181,00",
      "max_cents": 5444500,
      "max_formatted": "R$ 54.445,00"
    },
    "family_years": [
      {
        "value": "2020"
      }
    ],
    "ref_year": 2026,
    "ref_month": 10
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.