---
title: "List issued memberships"
method: GET
path: "/v1/issued_memberships"
tags: ["Issued memberships"]
---

# List issued memberships

`GET /v1/issued_memberships`

Returns paginated issued memberships

## Query parameters

- `limit` string
- `starting_after` string
- `ending_before` string
- `first_name` string
- `last_name` string
- `email` string
- `search` string
- `issued_membership_code` string
- `memberships_status` 'valid' | 'invalid' | 'both'
- `order_by` 'first_name' | 'last_name'
- `order` 'asc' | 'desc'
- `issued_after` integer
- `issued_before` integer
- `valid_from_after` integer
- `valid_from_before` integer
- `valid_to_after` integer
- `valid_to_before` integer

## Response `200`

A successfully returned list of issued memberships

- object
  - `data` IssuedMembership[]
    - `object` string — Object type identifier
    - `id` string — A unique identifier for the issued membership
    - `code` string — Unique membership code for identification and redemption
    - `benefits` string[] — List of benefits associated with this membership
    - `email` string — Email address of the member
    - `first_name` string — First name of the member
    - `full_name` string — Full name of the member
    - `is_valid` 'true' | 'false' — Whether the membership is currently valid (not expired and not voided)
    - `issue_date` object — Date and time when the membership was issued
      - `date` string — ISO-8601 date
      - `formatted` string — A formatted date string
      - `iso` string — ISO-8601 date and time
      - `time` string — Time of the date
      - `timezone` string — Timezone offset
      - `unix` integer — Unix timestamp
    - `last_name` string — Last name of the member
    - `max_redemptions` integer, nullable — Maximum number of redemptions allowed. Null means unlimited.
    - `membership_type_id` string — ID of the membership type
    - `membership_type_name` string — Name of the membership type
    - `redemption_collection` IssuedMembershipRedemption[] — List of redemptions made with this membership
      - `object` string — Object type identifier
      - `id` string — A unique identifier for the redemption
      - `created_at` string, date-time — ISO-8601 datetime when the redemption was created
      - `description` string — Description of the redemption
      - `issued_membership_id` string — ID of the issued membership this redemption belongs to
      - `linked_event_id` string, nullable — ID of the linked event, if applicable
      - `linked_order_id` string, nullable — ID of the linked order, if applicable
    - `redemptions` integer — Number of times this membership has been redeemed
    - `valid_from` object — Date and time when the membership becomes valid
      - `date` string — ISO-8601 date
      - `formatted` string — A formatted date string
      - `iso` string — ISO-8601 date and time
      - `time` string — Time of the date
      - `timezone` string — Timezone offset
      - `unix` integer — Unix timestamp
    - `valid_to` object — Date and time when the membership expires
      - `date` string — ISO-8601 date
      - `formatted` string — A formatted date string
      - `iso` string — ISO-8601 date and time
      - `time` string — Time of the date
      - `timezone` string — Timezone offset
      - `unix` integer — Unix timestamp
    - `voided_at` object, nullable — Date and time when the membership was voided. Null if not voided.
      - `date` string — ISO-8601 date
      - `formatted` string — A formatted date string
      - `iso` string — ISO-8601 date and time
      - `time` string — Time of the date
      - `timezone` string — Timezone offset
      - `unix` integer — Unix timestamp
  - `links` object
    - `next` string, nullable
    - `previous` string, nullable

## Other responses

- `default` — Error schema

---

[API](https://skmtc.net/tickettailor/apis/ticket-tailor-api.md) · [All operations](https://skmtc.net/tickettailor/apis/ticket-tailor-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tickettailor/ticket-tailor-api/revisions/7b222e8ec91c/schema)