# Listar etiquetas

`GET /labels`

Pasta: **Etiquetas**

## Autenticação

```http
token: {{token}}
```

## Descrição

# Listar etiquetas

Retorna todas as etiquetas cadastradas no banco da instância. Use para obter os IDs antes de `POST /chat/labels` ou `POST /label/edit`.

## Endpoint

`GET {{baseUrl}}/labels`

## Autenticação

Envie o token da instância no header `token: {{token}}`.

## Parâmetros

Nenhum.

## Exemplo de Requisição

```bash
curl --request GET '{{baseUrl}}/labels' \
  --header 'token: {{token}}'
```

## Resposta de Sucesso

```json
{
  "success": true,
  "labels": [
    {
      "id": "lbl_abc123",
      "name": "Cliente",
      "color": 1,
      "colorHex": "#00A884",
      "labelid": "10",
      "owner": "5511999999999"
    },
    {
      "id": "lbl_def456",
      "name": "VIP",
      "color": 2,
      "colorHex": "#25D366",
      "labelid": "20",
      "owner": "5511999999999"
    }
  ]
}
```

## Erros comuns

- `401 Unauthorized`: token ausente ou inválido.
- `500 Internal Server Error`: falha ao ler o banco de etiquetas.

## Observações

- Use o campo `labelid` (não só `id`) ao associar etiquetas a chats.

## cURL

```bash
curl -X GET "{{baseUrl}}/labels" \
  -H "token: {{token}}"
```

---

[Índice da pasta](./index.md) · [Índice geral](../index.md) · [UI](https://gozap.dev/docs?op=etiquetas/listar-etiquetas)