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

# Récupérer vos comptes

> Récupérez tous les comptes WhatsApp connectés à votre instance

## Récupérer tous vos comptes

Listez tous les comptes WhatsApp connectés à votre compte WaChap.

### Endpoint

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

### 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/whatsapp/accounts \
    -H "Authorization: Bearer token"
  ```

  ```javascript JAVASCRIPT theme={null}
  const response = await fetch('https://api.wachap.com/v1/whatsapp/accounts', {
    method: 'GET',
    headers: {
      'Authorization': 'Bearer token'
    }
  });

  const data = await response.json();
  console.log(data);
  ```

  ```python PYTHON theme={null}
  import requests

  url = "https://api.wachap.com/v1/whatsapp/accounts"
  headers = {"Authorization": "Bearer token"}

  response = requests.get(url, headers=headers)
  print(response.json())
  ```

  ```php PHP theme={null}
  <?php
  $curl = curl_init();

  curl_setopt_array($curl, [
    CURLOPT_URL => "https://api.wachap.com/v1/whatsapp/accounts",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
      "Authorization: Bearer token"
    ],
  ]);

  $response = curl_exec($curl);
  curl_close($curl);
  echo $response;
  ?>
  ```
</CodeGroup>

### Réponse

```json theme={null}
{
  "success": true,
  "accounts": [
    {
      "id": "account_abc123",
      "phoneNumber": "+33612345678",
      "name": "Mon compte principal",
      "status": "connected",
      "connectedAt": "2025-01-15T10:30:00Z"
    },
    {
      "id": "account_def456",
      "phoneNumber": "+33687654321",
      "name": "Compte secondaire",
      "status": "disconnected",
      "connectedAt": null
    }
  ]
}
```

### Status possibles

| Status         | Description              |
| :------------- | :----------------------- |
| `connected`    | Compte connecté et actif |
| `disconnected` | Compte déconnecté        |
| `connecting`   | Connexion en cours       |
| `error`        | Erreur de connexion      |

### Filtrer par status

```bash theme={null}
curl -X GET "https://api.wachap.com/v1/whatsapp/accounts?status=connected" \
  -H "Authorization: Bearer token"
```


## OpenAPI

````yaml GET /whatsapp/accounts
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/accounts:
    get:
      tags:
        - Comptes
      summary: Récupérer vos comptes
      description: Récupérez tous les comptes WhatsApp connectés à votre instance.
      parameters:
        - name: status
          in: query
          required: false
          schema:
            type: string
            enum:
              - connected
              - disconnected
              - connecting
              - error
          description: Filtrer par status de connexion
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  accounts:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        phoneNumber:
                          type: string
                        name:
                          type: string
                        status:
                          type: string
                          enum:
                            - connected
                            - disconnected
                            - connecting
                            - error
                        connectedAt:
                          type: string
                          format: date-time
              examples:
                default:
                  value:
                    success: true
                    accounts:
                      - id: account_abc123
                        phoneNumber: '+33612345678'
                        name: Mon compte principal
                        status: connected
                        connectedAt: '2025-01-15T10:30:00Z'
                      - id: account_def456
                        phoneNumber: '+33687654321'
                        name: Compte secondaire
                        status: disconnected
                        connectedAt: null
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````