---
title: "Versões de uma família em um ano-modelo"
method: GET
path: "/v1/brands/{brand}/families/{family}/years/{year}"
tags: ["Hubs"]
---

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

`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

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).

## Path parameters

- `brand` string, required
- `family` string, required
- `year` string, required

## Response `200`

Hub família-ano.

- GetFamilyYearHubResponse
  - `data` FamilyYearHub, required
    - `brand` Brand, required: Marca de hub: une as marcas FIPE de mesmo nome entre tipos de veículo. `slug` é estável e sem sufixo (`fiat`); pode coincidir com o slug de uma das marcas FIPE unidas, mas é um identificador próprio.
      - `slug` string, required
      - `name` string, required: Nome de exibição (ex. `Volkswagen` para "VW - VolksWagen").
      - `vehicle_types` string[], required: Tipos de veículo presentes (`vehicle_types.name`).
      - `family_count` integer, required
      - `version_count` integer, required: Versões FIPE (modelos) distintas com preço no período mais recente da marca. `family_count` conta as famílias com ao menos uma delas (o hub da marca também lista as famílias defasadas).
      - `make_slugs` string[], required: Slugs reais das marcas FIPE unidas.
    - `family_slug` string, required
    - `family_name` string, required
    - `year` YearOption, required: Representa um ano disponível para um modelo. Cada opção é auto-descritiva: `value` é o seletor canônico que pode ser enviado diretamente em `/v1/prices?year=<value>`.
      - `value` string, required: Seletor canônico do ano. `"2020"` para um ano-modelo, `"zero"` para um veículo 0km/novo. Use este valor em `year=` nos endpoints de preço.
      - `is_zero_km` boolean, required: `true` quando a opção é o veículo 0km/novo (`value == "zero"`); `false` para um ano-modelo concreto. Discriminador para ordenar e rotular sem precisar interpretar `value`.
    - `versions` FamilyYearVersion[], required: Ordenadas por `model_name`.
      - `model_name` string, required
      - `make_slug` string, required
      - `model_slug` string, required
      - `fuel_acronym` string, required
      - `fuel_name` string, required
      - `fipe_code` string, required
      - `vehicle_type` string, required
      - `price_cents` integer, required
      - `formatted_price` string, required
      - `change_from_previous_month_pct` number, float, nullable: Variação em relação ao mês anterior (fração, ex. `-0.0052` = -0,52%). Nulo quando indisponível.
      - `ref_year` integer, required: Período de referência do preço; mais antigo que o do hub quando a FIPE deixou de publicar a versão.
      - `ref_month` integer, required
    - `price` PriceRange, required
      - `min_cents` integer, required
      - `min_formatted` string, required
      - `max_cents` integer, required
      - `max_formatted` string, required
    - `family_years` YearOption[], required: Os anos-modelo do hub da família (seu período mais recente) mais este, para navegar entre os hubs de ano.
      - `value` string, required: Seletor canônico do ano. `"2020"` para um ano-modelo, `"zero"` para um veículo 0km/novo. Use este valor em `year=` nos endpoints de preço.
      - `is_zero_km` boolean, required: `true` quando a opção é o veículo 0km/novo (`value == "zero"`); `false` para um ano-modelo concreto. Discriminador para ordenar e rotular sem precisar interpretar `value`.
    - `ref_year` integer, required: Período de referência mais recente entre os preços do ano-modelo. Anterior ao mês mais recente da tabela quando o ano inteiro está defasado.
    - `ref_month` integer, required

## Other responses

- `400`: Erro de validação (400). Usado para TODOS os erros de validação — não há 422.
- `404`: Recurso não encontrado (404).
- `500`: Erro interno do servidor (500).

---

[API](https://skmtc.dev/fipex/apis/api-fipex.md) · [All operations](https://skmtc.dev/fipex/apis/api-fipex/llms.txt) · [OpenAPI document](https://skmtc.dev/fipex/apis/api-fipex/revisions/800eab7da73d?raw)