> For the complete documentation index, see [llms.txt](https://docs.api.epicbots.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.api.epicbots.xyz/coinsbot/users/recuperer-tous-les-utilisateurs-dun-serveur.md).

# Récupérer tous les utilisateurs d'un serveur

{% hint style="info" %}
Par défaut (**sans `limit`**), **tous** les utilisateurs sont renvoyés.
{% endhint %}

`GET` `/api/coinsbot/users/all`

***

### 🔧 Paramètres

| Paramètre | Requis |   Défaut   | Description                                                    |
| --------- | :----: | :--------: | -------------------------------------------------------------- |
| `GuildId` |    ✅   |      —     | ID du serveur                                                  |
| `apiKey`  |    ✅   |      —     | Clé API du serveur                                             |
| `limit`   |    ❌   | *(aucune)* | Nombre max de résultats. Absent = tout renvoyer. Max `100000`. |
| `offset`  |    ❌   |     `0`    | Décalage pour la pagination                                    |
| `sortBy`  |    ❌   |  *(aucun)* | Colonne de tri — voir ci-dessous                               |
| `order`   |    ❌   |    `asc`   | `asc` (croissant) ou `desc` (décroissant)                      |

#### 🔀 Valeurs de `sortBy`

`coins` · `bank` · `total` *(= coins + banque)* · `rep` · `livret` · `drugs` · `crypto` · `entrepot` · `xp` · `level` · `victoires` · `masterbalance` · `combowin` · `combolose`

{% hint style="info" %}
Le tri est **numérique**, même pour les colonnes stockées en texte en base.
{% endhint %}

***

### 💡 Exemples

**Tout le monde, trié par coins en main croissant :**

```http
GET /api/coinsbot/users/all?GuildId=123&apiKey=CLE&sortBy=coins&order=asc
```

**Les 25 plus riches (coins + banque), paginé :**

```http
GET /api/coinsbot/users/all?GuildId=123&apiKey=CLE&sortBy=total&order=desc&limit=25&offset=0
```

***

### ✅ Réponse `200`

Tableau d'objets utilisateur :

```json
[
  { "UserId": "111", "GuildId": "123", "Coins": 50, "Bank": 200, "Rep": 3 },
  { "UserId": "222", "GuildId": "123", "Coins": 120, "Bank": 0, "Rep": 1 }
]
```

***

### ❌ Erreurs

|  Code | Cause                                                          |
| :---: | -------------------------------------------------------------- |
| `400` | `GuildId` manquant, `sortBy`/`order`/`limit`/`offset` invalide |
| `401` | Clé API invalide                                               |
| `500` | Erreur interne                                                 |