---
title: "Lista os anos disponíveis de uma marca"
method: GET
path: "/v1/makes/{make_id}/years"
tags: ["Marcas", "Anos"]
---

# Lista os anos disponíveis de uma marca

`GET /v1/makes/{make_id}/years`

## Request

- Base URL: `https://api.fipex.com.br`
- URL: `https://api.fipex.com.br/v1/makes/{make_id}/years`
- Auth: none declared

Obtém os anos disponíveis para uma determinada marca de veículo.
Lista limitada: retorna todos os anos em `data`, com `pagination` de página única.

## Path parameters

- `make_id` string, uuid, required

## Query parameters

- `ref_id` string, uuid
- `model_id` string, uuid

## Response `200`

Anos obtidos com sucesso.

- ListModelYearsResponse: Lista limitada — retorna todos os anos em uma única página.
  - `data` YearOption[], required
    - `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`.
  - `pagination` Pagination, required
    - `total` integer, required: Número total de itens.
    - `limit` integer, required: Itens por página.
    - `page` integer, required: Número da página atual.
    - `pages` integer, required: Número total de páginas (mínimo 1, mesmo quando total=0).

## Other responses

- `400`: Erro de validação (400). Usado para TODOS os erros de validação — não há 422.
- `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)