---
title: "Obtém um preço por ID"
method: GET
path: "/v1/prices/{id}"
tags: ["Preços"]
---

# Obtém um preço por ID

`GET /v1/prices/{id}`

## Request

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

Recupera um registro de preço específico pelo seu UUID.
Retorna `VehicleDetailedPriceResponse` com envelope `{ "data": { ... } }` — igual a `GET /v1/prices/`.

## Path parameters

- `id` string, uuid, required

## Response `200`

Preço obtido 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)