---
title: "Obtém o histórico de preços"
method: GET
path: "/v1/prices/history"
tags: ["Preços", "Histórico"]
---

# Obtém o histórico de preços

`GET /v1/prices/history`

## Request

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

Recupera o histórico de dados de preços para um veículo específico.
Todos os três parâmetros são obrigatórios. Não há paginação — retorna o histórico completo.

## Query parameters

- `model_id` string, uuid, required
- `fuel_id` string, uuid, required
- `year` union, required
  - integer
  - 'zero'

## Response `200`

Histórico de preços obtido com sucesso.

- VehiclePriceHistoryResponse
  - `data` VehiclePriceSnapshot[], required
    - `year` integer, required
    - `month` integer, required
    - `market_price_cents` integer, required: Preço de mercado em centavos.
    - `formatted_price` string, required
    - `cohort_median_cents` integer, nullable: Mediana de preço da coorte de veículos comparáveis, em centavos. Definido apenas em `/v1/prices/expanded`; nulo quando indisponível.
  - `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.
- `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)