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

# Statut d’une campagne

> Obtenez le statut détaillé et les statistiques d’une campagne

## Statut d'une campagne

Obtenez le statut détaillé et les statistiques d'une campagne.

### Endpoint

<ParamField method="GET" path="/v1/campaigns/:id/status" />

### Headers

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

### URL Parameters

<ParamField path="id" type="string" required>
  L'identifiant de la campagne
</ParamField>

### Exemples de requêtes

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

  ```javascript JAVASCRIPT theme={null}
  // Polling pour suivi temps réel
  const response = await fetch('https://api.wachap.com/v1/campaigns/campaign_abc123/status', {
    headers: { 'Authorization': 'Bearer token' }
  });
  const data = await response.json();
  console.log(`Progression: ${data.campaign.progress.percentage}%`);
  ```
</CodeGroup>

### Exemple de réponse

```json theme={null}
{
  "success": true,
  "campaign": {
    "id": "campaign_abc123",
    "name": "Campagne Promotionnelle Janvier",
    "status": "running",
    "totalContacts": 150,
    "sent": 87,
    "failed": 3,
    "pending": 60,
    "progress": {
      "percentage": 60,
      "successRate": 96.67,
      "failureRate": 3.33,
      "estimatedTimeRemaining": 120000
    }
  }
}
```

### Champs de la réponse

| Champ                             | Description                                                         |
| :-------------------------------- | :------------------------------------------------------------------ |
| `status`                          | Statut actuel (`draft`, `running`, `paused`, `completed`, `failed`) |
| `totalContacts`                   | Nombre total de contacts                                            |
| `sent`                            | Messages envoyés avec succès                                        |
| `failed`                          | Messages échoués                                                    |
| `pending`                         | Messages en attente                                                 |
| `progress.percentage`             | Pourcentage de progression (0-100)                                  |
| `progress.estimatedTimeRemaining` | Temps restant estimé (ms)                                           |

### Codes d'erreur

| Code  | Description                                 |
| :---- | :------------------------------------------ |
| `401` | INVALID\_SECRET\_KEY - Clé secrète invalide |
| `404` | CAMPAIGN\_NOT\_FOUND - Campagne non trouvée |


## OpenAPI

````yaml GET /campaigns/{id}/status
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/{id}/status:
    get:
      tags:
        - Campagnes
      summary: Statut d'une campagne
      description: Obtenez le statut détaillé et les statistiques.
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````