---
title: "Famílias de modelo de uma marca"
method: GET
path: "/v1/brands/{brand}"
tags: ["Hubs"]
---

# Famílias de modelo de uma marca

`GET /v1/brands/{brand}`

## Request

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

Hub da marca: suas famílias de modelo com faixa de anos-modelo, número
de versões e faixa de preço atual. Aceita também o slug real de uma
marca FIPE unida (`fiat-21` responde com a marca `fiat`). Marca
desconhecida ou sem veículos com preço retorna `404`.

Nenhum agregado dos hubs mistura períodos de referência: cada grupo
(marca, família, família-ano) agrega só as versões com preço no seu
período mais recente — o mês mais recente da tabela, se alguma versão
do grupo tem preço nele. Um grupo sem nenhuma versão no mês mais
recente ("defasado": a FIPE deixou de precificá-lo) continua
respondendo, agregado só pelo seu próprio último mês, e informa esse
`ref_year`/`ref_month` mais antigo onde a resposta o tem. As famílias
defasadas também são listadas aqui.

Preço zero não conta como preço em nenhum hub (nem em
`/v1/sitemap-hubs`): a FIPE publicou R$ 0 para alguns anos-modelo
(ADLY ATV 100, 2012-09). Um grupo cujos únicos preços são zero não
existe como hub — responde `404` e fica fora do índice e do sitemap
—, e faixas de preço e medianas nunca mostram R$ 0,00. As páginas
de veículo desses anos-modelo continuam existindo.

Todos os hubs (e `/v1/sitemap-hubs`) saem de um retrato do catálogo
mantido em memória pela API: mudanças na base aparecem em até 2
minutos.

## Path parameters

- `brand` string, required

## Response `200`

Hub da marca.

- GetBrandHubResponse
  - `data` BrandHub, required
    - `brand` Brand, required: Marca de hub: une as marcas FIPE de mesmo nome entre tipos de veículo. `slug` é estável e sem sufixo (`fiat`); pode coincidir com o slug de uma das marcas FIPE unidas, mas é um identificador próprio.
      - `slug` string, required
      - `name` string, required: Nome de exibição (ex. `Volkswagen` para "VW - VolksWagen").
      - `vehicle_types` string[], required: Tipos de veículo presentes (`vehicle_types.name`).
      - `family_count` integer, required
      - `version_count` integer, required: Versões FIPE (modelos) distintas com preço no período mais recente da marca. `family_count` conta as famílias com ao menos uma delas (o hub da marca também lista as famílias defasadas).
      - `make_slugs` string[], required: Slugs reais das marcas FIPE unidas.
    - `families` BrandFamily[], required: Ordenadas por `slug`.
      - `slug` string, required
      - `name` string, required
      - `vehicle_types` string[], required
      - `version_count` integer, required: Versões FIPE (modelos) distintas com preço no período mais recente da família.
      - `first_year` integer, required: Ano-modelo mais antigo com preço no período mais recente da família; `0` se só tem 0km.
      - `last_year` integer, required: Ano-modelo mais novo com preço no período mais recente da família; `0` se só tem 0km.
      - `has_zero_km` boolean, required: Se há 0km com preço no período mais recente da família.
      - `price` PriceRange, required
        - `min_cents` integer, required
        - `min_formatted` string, required
        - `max_cents` integer, required
        - `max_formatted` 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).
- `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)