---
title: "Lista os modelos de veículos"
method: GET
path: "/v1/models"
tags: ["Modelos"]
---

# Lista os modelos de veículos

`GET /v1/models`

## Request

- Base URL: `https://api.fipex.com.br`
- URL: `https://api.fipex.com.br/v1/models`
- Auth: none declared

Recupera uma lista paginada de modelos de veículos com filtros e busca opcionais.

**Filtros Disponíveis:**
- `id`: Filtro por UUID v7 com operadores `=`, `!=`, `IN`, `NOT IN`.
- `name`: Filtro de texto com operadores `=`, `!=`, `CONTAINS`, `NOT CONTAINS`.

**Ordenação:**
- `name`: Ordena pelo nome do modelo (padrão: ascendente).

**Filtros adicionais por parâmetro plano:** `ref_id` filtra modelos que possuem preços no período de referência indicado; `year` filtra modelos disponíveis naquele ano.

## Query parameters

- `page` integer
- `limit` integer
- `order_by` union
  - string
  - string[]
- `q` string
- `make_id` string, uuid
- `fuel_id` string, uuid
- `type_id` string, uuid
- `ref_id` string, uuid
- `year` integer
- `filters` FilterExpression[]
  - `field` string, required: Nome do campo para filtrar.
  - `op` '=' | '!=' | '>' | '<' | '>=' | '<=' | 'CONTAINS' | 'NOT CONTAINS' | 'IN' | 'NOT IN' | 'TO' | 'IS NULL', required: Operador do filtro.
  - `value` string: Valor do filtro (o tipo depende do campo e do operador). Para IN/NOT IN/TO use vírgula como separador.
  - `negate` boolean: Se deve negar a condição do filtro.
  - `condition` 'AND' | 'OR': Condição lógica para combinar com outros filtros.

## Response `200`

Lista de modelos obtida com sucesso.

- ListModelsResponse
  - `data` SimplifiedModel[], required
    - `id` string, uuid, required
    - `name` string, required: Nome do modelo.
    - `make_id` string, uuid, required: UUID da marca à qual o modelo pertence.
    - `slug` string, required: Identificador do modelo em formato slug.
  - `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)