---
title: "Obtém um modelo por ID"
method: GET
path: "/v1/models/{id}"
tags: ["Modelos"]
---

# Obtém um modelo por ID

`GET /v1/models/{id}`

## Request

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

Recupera um modelo de veículo específico pelo seu UUID, incluindo combustíveis disponíveis por ano.

## Path parameters

- `id` string, uuid, required

## Response `200`

Modelo obtido com sucesso.

- GetModelResponse
  - `data` Model, required: Modelo de veículo com marca, tipo e combustíveis disponíveis por ano.
    - `id` string, uuid, required
    - `name` string, required: Nome do modelo (ex: "Civic EX").
    - `slug` string, required: Identificador em formato slug (ex: "civic-ex").
    - `make` Make, required: Marca (fabricante) de veículos.
      - `id` string, uuid, required
      - `name` string, required: Nome da marca (ex: "Honda").
      - `slug` string, required: Identificador em formato slug (ex: "honda").
    - `type` VehicleType, required: Tipo de veículo (carro, motocicleta ou caminhão).
      - `id` string, uuid, required
      - `name` string, required: Nome legível (ex: "Carros").
      - `slug` string, required: Identificador em formato slug (ex: "carros").
    - `year_fuels` ModelYearFuels[], required: Combustíveis disponíveis por ano-modelo.
      - `model_year` integer: Ano do modelo.
      - `is_zero_km` boolean: Indica se é um veículo zero km.
      - `fuels` Fuel[]
        - `id` string, uuid, required
        - `acronym` string, required: Acrônimo do combustível (ex. "g", "e", "d").
        - `name` string, 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).
- `409`: Expectativa conflitante — múltiplas linhas retornadas onde era esperada apenas uma (409).
- `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)