---
title: "Compara preços de veículos"
method: GET
path: "/v1/prices/compare"
tags: ["Preços", "Comparação"]
---

# Compara preços de veículos

`GET /v1/prices/compare`

## Request

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

Compara preços entre múltiplos veículos (1–10) usando um formato específico.

**Formato de Especificação do Veículo:**
Cada veículo é especificado como: `slug-do-modelo,acrônimo-do-combustivel,ano`
Múltiplos veículos são separados por ponto e vírgula (`;`, ou `%3B` em percent encoding).

Se nenhuma especificação produzir resultado (count mismatch), retorna **200 com array vazio** (não 409 nem 400).

**Exemplo:**
`vehicle_specs=850-glt-2-5-20v,g,1997;850-glt-2-5-20v,g,1996`

## Query parameters

- `vehicle_specs` string, required

## Response `200`

Comparação de preços obtida com sucesso.

- CompareVehiclePricesResponse
  - `data` VehicleWithHistory[], required
    - `price_id` string, uuid, required
    - `model_id` string, uuid, required
    - `model_name` string, required
    - `model_slug` string, required
    - `make_id` string, uuid, required
    - `make_name` string, required
    - `make_slug` string, required
    - `fuel_id` string, uuid, required
    - `fuel_name` string, required
    - `fuel_acronym` string, required
    - `type_id` string, uuid, required
    - `type_name` string, required
    - `model_year` integer: Ano do modelo (oneof com is_zero_km).
    - `is_zero_km` boolean: Indica veículo zero km (oneof com model_year).
    - `price_history` 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.
    - `fipe_code` string, required: Código FIPE público, ex: "811049-7".
  - `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)