# Mitgliedschaftsliste

**GET** `/v1/memberships`

Gibt eine paginierte Liste der Mitgliedschaften des Tenants zurück. Nicht-Admins sehen nur eigene Mitgliedschaften. Admins können nach `user_id` filtern.

### Abfrageparameter

| Parameter | Typ | Beschreibung |
|---|---|---|
| `listing_id` | integer | Nach Membership-Listing filtern |
| `status` | string | Nach Status filtern: `active`, `expired`, `cancelled` |
| `membership_id` | string | Nach externer Mitgliedschafts-ID filtern |
| `user_id` | integer | Nach Benutzer filtern (nur Admins) |
| `page` | integer | Seitennummer (Standard: 1) |
| `per_page` | integer | Ergebnisse je Seite (Standard: 30, maximal 100) |

### Antwortfelder

**memberships** — Array von Mitgliedschaftsobjekten. <br>
**pagination.total** — Anzahl passender Mitgliedschaften. <br>
**pagination.page** — Aktuelle Seite. <br>
**pagination.per_page** — Seitengröße.