# Member subscriptions

A loyalty member with an active [subscription](/digital-platform/subscriptions) may gain access to exclusive
[subscription benefits](/digital-platform/subscriptions/benefits).

## Get member subscriptions

Use the [GetCurrentMember](/openapi/digital-platform/openapi/members/ocapimembers_getcurrentmember/) endpoint to get
the authenticated member's `subscriptions`.

```json
{
  "member": {
    "id": "string",
    "hash": "string",
    "subscriptions": {
      "current": {
        "subscriptionId": 0,
        "status": "Active",
        "startsAt": "2019-08-24T14:15:22Z",
        "expiresAt": "2019-08-24T14:15:22Z",
        "contractedTermEndsAt": "2019-08-24T14:15:22Z",
        "billingDetails": {
          "isRecurring": true,
          "reactivationPrice": {
            "valueIncludingTax": 0.1,
            "valueExcludingTax": 0.1,
            "tax": 0.1
          },
          "isUsingThirdPartyPaymentProvider": true,
          "currentBillingPeriodStartsAt": "2019-08-24T14:15:22Z",
          "nextBillingPeriodStartsAt": "2019-08-24T14:15:22Z",
          "billingError": {
            "willBeRetried": true
          },
          "hasLastContractedPaymentBeenMade": true,
          "hasNextBillingPeriodPriceAdjustment": true
        },
        "holdPeriod": {
          "startDate": "2019-08-24T14:15:22Z",
          "endDate": "2019-08-24T14:15:22Z"
        },
        "isCancellationAllowed": true,
        "cancelsAt": "2019-08-24T14:15:22Z"
      },
      "future": null,
      "canPurchaseFutureSubscription": false,
      "canPurchaseFutureSubscriptionAt": "2019-08-24T14:15:22Z"
    }
  }
}
```

## Current subscription

A member's `current` subscription provides the member access to [subscription benefits](/digital-platform/subscriptions/benefits)
while it is in an `Active` state.

## Future subscription

The member will have a `future` subscription if they have [purchased a future subscription](/digital-platform/subscriptions/purchase/future-subscriptions).

A member's `future` subscription will provide the member access to [subscription benefits](/digital-platform/subscriptions/benefits) when their `current` subscription ends.

## Member subscription status

Each member subscription has a `status` property that indicates the current state of the subscription.

### Active

The subscription is `Active` and the member has access to their [subscription benefits](/digital-platform/subscriptions/benefits).

### Frozen

The subscription is `Frozen` due to a repeated [billing error](/digital-platform/subscriptions/recurring/billing-errors). The member needs to manually [reactivate their subscription](/digital-platform/subscriptions/recurring/reactivation) to re-enable their [subscription benefits](/digital-platform/subscriptions/benefits).

### On hold

The subscription is `OnHold` due to a member-initiated [hold period](/digital-platform/subscriptions/hold-periods). The member will automatically regain access to their [subscription benefits](/digital-platform/subscriptions/benefits) when the hold period ends.

### Not started

A member's [future subscription](#future-subscription) will have the `NotStarted` status while their [current subscription](#current-subscription) is still `Active`.

The member will have access to the [subscription benefits](/digital-platform/subscriptions/benefits) of their current subscription during this time, but won't have access to their future subscription until it becomes `Active`.

## Member subscription cards

A member with an active subscription will have a `MemberSubscriptionCard` that can be used to purchase [Subscription tickets](/digital-platform/orders/standard-orders/subscription-tickets).

Use the [GetMemberTicketRedemptionCards](/openapi/digital-platform/openapi/ticket-redemption-cards/ocapimemberticketredemptioncards_getmemberticketredemptioncards/) endpoint to get the authenticated member's ticket redemption 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.