# Liste des adhésions

**GET** `/v1/memberships`

Renvoie une liste paginée des adhésions du tenant. Les utilisateurs non administrateurs ne voient que leurs propres adhésions. Les administrateurs peuvent filtrer par `user_id`.

### Paramètres de requête

| Paramètre | Type | Description |
|---|---|---|
| `listing_id` | integer | Filtre par annonce d'adhésion |
| `status` | string | Filtre par statut : `active`, `expired`, `cancelled` |
| `membership_id` | string | Filtre par ID d'adhésion externe |
| `user_id` | integer | Filtre par utilisateur (administrateurs uniquement) |
| `page` | integer | Numéro de page (1 par défaut) |
| `per_page` | integer | Résultats par page (30 par défaut, 100 maximum) |

### Champs de la réponse

**memberships** — Tableau d'objets d'adhésion. <br>
**pagination.total** — Nombre total d'adhésions correspondantes. <br>
**pagination.page** — Page actuelle. <br>
**pagination.per_page** — Taille de la page.