---
title: "Encontra o preço de um veículo"
method: GET
path: "/v1/prices"
tags: ["Preços"]
---

# Encontra o preço de um veículo

`GET /v1/prices`

## Request

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

Encontra um preço de veículo específico fornecendo ou o ID do modelo + ID do combustível, ou o slug do modelo + acrônimo do combustível.

**Parâmetros Obrigatórios (escolha uma combinação):**
- `model_id` (UUID v7) + `fuel_id` (UUID v7) + `year`
- `model_slug` + `fuel_acronym` + `year`

**Parâmetros Opcionais:**
- `ref_id`: UUID v7 de um período de referência específico.
- `ref_date`: Data de referência no formato **AAAA-MM** (ex: `2025-06`). Se o formato for inválido, retorna **400**.

Retorna `VehicleDetailedPriceResponse` com envelope `{ "data": { ... } }`.

## Query parameters

- `model_id` string, uuid
- `fuel_id` string, uuid
- `model_slug` string
- `fuel_acronym` string
- `year` union, required
  - integer
  - 'zero'
- `ref_id` string, uuid
- `ref_date` string

## Response `200`

Preço encontrado com sucesso.

- VehicleDetailedPriceResponse: Envelope de resposta para GET /v1/prices.
  - `data` VehicleDetailedPrice, required: Dados de preço detalhados de um veículo. Campo condicional (oneof): `model_year` ou `is_zero_km`. O campo `price_cents` é em centavos (uint32).
    - `price_cents` integer: Preço em centavos (uint32).
    - `formatted_price` string: Preço formatado para leitura humana.
    - `model_year` integer: Ano do modelo (oneof com is_zero_km).
    - `is_zero_km` boolean: Indica veículo zero km (oneof com model_year).
    - `query_date` string, date-time: Data da consulta do preço.
    - `make` Make: 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").
    - `model` SimplifiedModel: Modelo de veículo em forma reduzida — sem relações aninhadas, apenas o `make_id`.
      - `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.
    - `fuel` Fuel: Combustível. Não possui campo `slug` no proto.
      - `id` string, uuid, required
      - `acronym` string, required: Acrônimo do combustível (ex. "g", "e", "d").
      - `name` string, required
    - `type` VehicleType: 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").
    - `reference` ReferencePeriod: Período de referência mensal de uma tabela FIPE.
      - `id` string, uuid, required
      - `month` integer, required: Mês de referência (1-12).
      - `month_name` string, required: Nome do mês por extenso (ex: "Junho").
      - `year` integer, required: Ano de referência.
      - `price_count` integer, required: Quantidade de preços publicados nesta referência (estoque).
      - `added` integer, nullable: Combinações veículo/ano/combustível presentes nesta referência e ausentes na referência anterior (fluxo). Ausente (null) na referência mais antiga do dataset, que não tem antecessora — nesse caso o valor nunca é 0.
      - `removed` integer, nullable: Combinações veículo/ano/combustível presentes na referência anterior e ausentes nesta (fluxo). Ausente (null) na referência mais antiga do dataset, que não tem antecessora — nesse caso o valor nunca é 0.
      - `fipe_id` integer, required: Número de sequência de publicação da própria FIPE. Chave monotônica que ordena as referências (prefira-a a tuplas (year, month)).
    - `fipe_code` string: Código FIPE público, ex: "811049-7".
    - `body_type_id` string: ID da carroceria (vazio se não classificado).
    - `body_type_name` string: Nome da carroceria.
    - `body_type_slug` string: Slug da carroceria.

## 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)