> ## Documentation Index
> Fetch the complete documentation index at: https://dev.wachap.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Lister les étiquettes

> Récupérez les étiquettes d’un compte WhatsApp

### Endpoint

<ParamField method="GET" path="/v1/whatsapp/labels" />

### Paramètres

<ParamField query="accountId" type="string" required>
  Identifiant du compte WhatsApp.
</ParamField>

<ParamField query="sync" type="boolean">
  Utilisez `true` pour demander une synchronisation avec WhatsApp avant de retourner la liste. Par défaut, WaChap utilise le cache disponible.
</ParamField>

### Exemple

```bash theme={null}
curl "https://api.wachap.com/v1/whatsapp/labels?accountId=account_123&sync=true" \
  -H "Authorization: Bearer token"
```

### Réponse

```json theme={null}
{
  "success": true,
  "labels": [
    {
      "accountId": "account_123",
      "labelId": "label_vip",
      "name": "VIP",
      "color": 1,
      "deleted": false,
      "source": "sync"
    }
  ],
  "total": 1,
  "sync": {
    "requested": true,
    "success": true,
    "cached": true
  }
}
```


## OpenAPI

````yaml GET /whatsapp/labels
openapi: 3.0.3
info:
  title: WaChap API
  version: 2.0.0
servers:
  - url: https://api.wachap.com/v1
    description: WaChap API server
security:
  - BearerAuth: []
tags:
  - name: Instances
    description: Créer et gérer des instances WhatsApp
  - name: Webhook
    description: Configuration des webhooks de réception
  - name: Messages
    description: Envoyer des messages WhatsApp
  - name: Comptes
    description: Gérer vos comptes WhatsApp connectés
  - name: SMS
    description: Service SMS de WaChap (V4) via FCM
  - name: Étiquettes WhatsApp
    description: Créer et associer des étiquettes aux conversations WhatsApp
paths:
  /whatsapp/labels:
    get:
      tags:
        - Étiquettes WhatsApp
      summary: Lister les étiquettes WhatsApp
      description: >-
        Retourne les étiquettes actives d’un compte. Le paramètre sync demande
        une synchronisation préalable avec WhatsApp.
      operationId: listWhatsAppLabels
      parameters:
        - name: accountId
          in: query
          required: true
          schema:
            type: string
        - name: sync
          in: query
          required: false
          schema:
            type: boolean
            default: false
      responses:
        '200':
          description: >-
            Liste des étiquettes, avec l’état de synchronisation lorsqu’il est
            demandé
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  labels:
                    type: array
                    items:
                      $ref: '#/components/schemas/WhatsAppLabel'
                  total:
                    type: integer
                  sync:
                    type: object
                  warning:
                    type: object
        '409':
          description: >-
            La synchronisation WhatsApp nécessite une réparation ou une
            réinitialisation contrôlée
components:
  schemas:
    WhatsAppLabel:
      type: object
      properties:
        id:
          type: string
        userId:
          type: string
        accountId:
          type: string
        labelId:
          type: string
        name:
          type: string
        color:
          type: integer
        deleted:
          type: boolean
        createdAt:
          type: string
        updatedAt:
          type: string
        syncedAt:
          type: string
        fromSync:
          type: boolean
        source:
          type: string
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````