> ## 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 campagnes

> Récupérez toutes vos campagnes

## Lister les campagnes

Récupérez la liste de toutes vos campagnes, triées par date de création décroissante.

### Endpoint

<ParamField method="GET" path="/v1/campaigns" />

### Headers

<ParamField header="Authorization" type="string" required>
  Bearer token avec votre Secret Key (format: `Bearer sk_...`)
</ParamField>

### Exemples de requêtes

<CodeGroup>
  ```bash BASH theme={null}
  curl -X GET https://api.wachap.com/v1/campaigns \
    -H "Authorization: Bearer token"
  ```
</CodeGroup>

### Exemple de réponse

```json theme={null}
{
  "success": true,
  "total": 5,
  "campaigns": [
    {
      "id": "campaign_abc123",
      "name": "Campagne Promotionnelle Janvier",
      "status": "completed",
      "totalContacts": 150,
      "sent": 148,
      "failed": 2,
      "createdAt": "2024-01-15T10:00:00.000Z"
    },
    {
      "id": "campaign_def456",
      "name": "Newsletter Février",
      "status": "running",
      "totalContacts": 300,
      "sent": 125,
      "pending": 170
    }
  ]
}
```

### Statuts possibles

| Statut      | Description                       |
| :---------- | :-------------------------------- |
| `draft`     | Campagne créée, pas encore lancée |
| `running`   | Campagne en cours d'envoi         |
| `paused`    | Campagne mise en pause            |
| `completed` | Campagne terminée avec succès     |
| `failed`    | Campagne échouée                  |

### Codes d'erreur

| Code  | Description                                 |
| :---- | :------------------------------------------ |
| `401` | INVALID\_SECRET\_KEY - Clé secrète invalide |


## OpenAPI

````yaml GET /campaigns
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:
  /campaigns:
    get:
      tags:
        - Campagnes
      summary: Lister les campagnes
      description: Récupérez toutes vos campagnes.
      responses:
        '200':
          description: OK
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````