Subscription tickets

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

Subscription ticket flow

Get member ticket redemption cards

Use the GetMemberTicketRedemptionCards endpoint to get the authenticated member's subscription cards.

This endpoint returns the authenticated member's MemberSubscriptionCard (if they have a subscription), and any friend's cards that have been shared with the member.

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

Copy

Copied

{
  "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 endpoint to add the MemberTicketRedemptionCard to an in-progress standard order by specifying the memberTicketRedemptionCardId and showtimeId.

Copy

Copied

{
  "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.

Copy

Copied

{
  "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, use the ticketRedemptionCardId (i.e., the id returned by the AddTicketRedemptionCard endpoint) to add tickets with a MemberSubscriptionCard restriction.

Copy

Copied

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