---
title: "Busca labels para autocompletar"
method: GET
path: "/v1/search/labels"
tags: ["Busca", "Marcas", "Modelos"]
---

# Busca labels para autocompletar

`GET /v1/search/labels`

## Request

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

Retorna sugestões leves (`id`, `name`, `slug`) de modelos **ou** marcas — ideal para
campos de autocompletar. Use `type` para escolher o que buscar.

Em buscas `type=model`, o servidor tenta extrair o nome da marca do termo e filtrar por ela
automaticamente; passe `make_id` para restringir explicitamente a uma marca.

```
GET /v1/search/labels?type=model&q=civic&make_id=<uuid>
```

## Query parameters

- `page` integer
- `limit` integer
- `q` string, required
- `type` 'model' | 'make', required
- `vehicle_type_id` string, uuid
- `make_id` string, uuid

## Response `200`

Labels obtidos com sucesso.

- SearchLabelResponse
  - `data` SearchLabel[], required
    - `id` string, uuid, required
    - `name` string, required: Nome a ser exibido na sugestão.
    - `slug` string, required: Identificador em formato slug.
  - `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)