# Subscription tickets

A member with an active subscription may have access to exclusive ticket types.

## Subscription ticket flow

```mermaid
flowchart TB
    A(Get member ticket redemption cards) --> B
    B(Add ticket redemption card to order) --> C
    C(Add subscription tickets to order)
```

## Get member ticket redemption cards

Use the [GetMemberTicketRedemptionCards](/openapi/digital-platform/openapi/ticket-redemption-cards/ocapimemberticketredemptioncards_getmemberticketredemptioncards/) endpoint to get the authenticated member's [subscription cards](/digital-platform/loyalty/member-subscriptions#member-subscription-cards).

This endpoint returns the authenticated member's `MemberSubscriptionCard` (if they have a subscription), and
any [friend's cards](/digital-platform/loyalty/member-friends) that have been shared with the member.

The `status` property indicates whether the subscription is currently `Active` and available for ticket redemption.

```json
{
  "ticketRedemptionCards": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "type": "MemberSubscriptionCard",
      "maskedCardNumber": "string",
      "subscriptionId": 0,
      "thirdPartyMemberSchemeId": "string",
      "memberName": {
        "givenName": "string",
        "familyName": "string",
        "middleName": "string"
      },
      "friendId": null,
      "status": "Active"
    }
  ]
}
```

NOTE
Some properties have been omitted from the code snippet above for brevity.

## Add ticket redemption card to order

Use the [AddTicketRedemptionCard](/openapi/digital-platform/openapi/ticket-redemption-cards/ocapiorderticketredemptioncards_addticketredemptioncard/) endpoint to add the `MemberTicketRedemptionCard` to an in-progress standard order by specifying the `memberTicketRedemptionCardId` and `showtimeId`.

```json
{
  "type": "MemberTicketRedemptionCard",
  "memberTicketRedemptionCardId": "f41d4c72-96c0-481b-ac55-a3286e384fd5",
  "showtimeId": "string"
}
```

This endpoint returns a `redemptionLimit` object that indicates the maximum number of tickets that can be redeemed for the specified `MemberSubscriptionCard`.

```json
{
  "ticketRedemptionCard": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "type": "MemberSubscriptionCard",
    "maskedCardNumber": "string",
    "subscriptionId": 0,
    "thirdPartyMemberSchemeId": "string",
    "memberName": {
      "givenName": "string",
      "familyName": "string",
      "middleName": "string"
    }
  },
  "redemptionLimit": {
    "isUnlimited": true,
    "maximum": 0,
    "minimum": 0
  }
}
```

## Add subscription tickets to order

When [ordering tickets](/digital-platform/orders/standard-orders/ordering-tickets), use the `ticketRedemptionCardId` (i.e., the `id` returned by the [AddTicketRedemptionCard](/openapi/digital-platform/openapi/ticket-redemption-cards/ocapiorderticketredemptioncards_addticketredemptioncard/) endpoint) to add tickets with a `MemberSubscriptionCard` restriction.

```json
{
  "tickets": [
    {
      "id": "string",
      "ticketTypeId": "string",
      "ticketRedemptionCardId": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
    }
  ]
}
```