# Lista de membresías

**GET** `/v1/memberships`

Devuelve una lista paginada de membresías del tenant. Los usuarios no administradores solo ven las propias. Los administradores pueden filtrar por `user_id`.

### Parámetros de consulta

| Parámetro | Tipo | Descripción |
|---|---|---|
| `listing_id` | integer | Filtra por anuncio de membresía |
| `status` | string | Filtra por estado: `active`, `expired`, `cancelled` |
| `membership_id` | string | Filtra por ID de membresía externo |
| `user_id` | integer | Filtra por usuario (solo administradores) |
| `page` | integer | Número de página (1 de forma predeterminada) |
| `per_page` | integer | Resultados por página (30 predeterminado, máximo 100) |

### Campos de la respuesta

**memberships** — Array de objetos de membresía. <br>
**pagination.total** — Total de membresías coincidentes. <br>
**pagination.page** — Página actual. <br>
**pagination.per_page** — Tamaño de página.