---
title: "Get available host memberships"
method: GET
path: "/api/v2/host/memberships"
tags: ["host"]
---

# Get available host memberships

`GET /api/v2/host/memberships`

## Query parameters

- `page` integer, required
- `pageSize` integer, required
- `sortOrder` 'ASC' | 'DESC'
- `sortBy` 'name' | 'orderNumber'
- `includeDisabled` boolean
- `onlyFeatured` boolean
- `compatibleWithSessionId` integer
- `compatibleWithAppointmentId` integer

## Response `200`

- object
  - `pagination` PaginatedResponseDataDto, required
    - `page` integer, required
    - `pageSize` integer, required
    - `totalCount` integer, required
    - `sortBy` string
    - `sortOrder` 'ASC' | 'DESC'
  - `payload` ApiV2HostMembershipDto[], required
    - `id` integer, required
    - `name` string, required
    - `description` string, nullable, required
    - `type` 'subscription' | 'on-demand-subscription' | 'package-events' | 'package-money' | 'patron', required
    - `locationId` integer, nullable, required
    - `disabled` boolean, required — Indicates that the membership was disabled and shouldn't be shown
    - `autoRenewing` boolean, required — Indicates that membership renews after specific interval
    - `minimumAutoRenews` integer, nullable, required — How many times membership has to renew before user can cancel renewal
    - `eventCredits` integer, nullable, required — For PACKAGE_EVENTS memberships, defines how many event credits are included
    - `moneyCredits` number, nullable, required — For PACKAGE_MONEY memberships, defines how much money is included
    - `duration` integer, nullable, required — For SUBSCRIPTION this is auto renew duration, for PACKAGE_* this is expiration time
    - `durationUnit` 'days' | 'months' | 'years', nullable, required
    - `isActivatedOnFirstUse` boolean, required — If set to false, membership is activated upon purchase. When set to true, membership is activated at the moment of the first purchase. When the purchase is for booking in the future, the activation date is set to the booking date.
    - `activationDeadlineInDays` integer, nullable, required — Only applicable when isActivatedOnFirstUse=true. If set, the member must activate the membership within this many days of purchase or it expires automatically.
    - `hasFreeTrial` boolean, required
    - `freeTrialDurationInDays` integer, required
    - `contractAgreement` string, nullable, required
    - `order` integer, required
    - `isIntroOffer` boolean, required
    - `usageLimitForSessions` number, nullable, required — Only applicable for SUBSCRIPTION. Maximum number of sessions customer can book with this membership during one renewal period, not used when combinedUsageLimitEnabled=true
    - `usageLimitForAppointments` number, nullable, required — Only applicable for SUBSCRIPTION. Maximum number of appointments customer can book with this membership during one renewal period, not used when combinedUsageLimitEnabled=true
    - `combinedUsageLimitEnabled` boolean, required — Only applicable for SUBSCRIPTION. The usage limits of the memberships are applied to sum of both bookings and appointments.
    - `combinedUsageLimit` number, nullable, required — Only applicable for SUBSCRIPTION. Combined maximum number of bookings and appointments customer can book with this membership during one renewal period, only used when combinedUsageLimitEnabled=true
    - `usageLimitRenewalEnabled` boolean, required — Only applicable for SUBSCRIPTION. Calculate usage limits differently to renewal duration.
    - `usageLimitRenewalDuration` number, nullable, required — Only applicable for SUBSCRIPTION. Interval for which the usage limits are calculated, only used when usageLimitRenewalEnabled=true
    - `usageLimitRenewalDurationUnit` 'days' | 'months' | 'years', nullable, required — Only applicable for SUBSCRIPTION. Interval for which the usage limits are calculated, only used when usageLimitRenewalEnabled=true
    - `usageLimitRolloverEnabled` boolean, required — Only applicable for SUBSCRIPTION. When true and customer doesn't use reach their usage limits, the rest is transferred to the customer according to usageLimitRolloverMode
    - `usageLimitRolloverMode` 'next-renewal' | 'event-credits', nullable, required — Only applicable for SUBSCRIPTION. How should extra usage limits be transferred to customer, either as package or as addition to next renewal period. Only used when usageLimitRolloverEnabled=true
    - `usageLimitRolloverExpirationDuration` number, nullable, required — Only applicable for SUBSCRIPTION. When should the extra limits / package expire after rolling over. Only used when usageLimitRolloverEnabled=true
    - `usageLimitRolloverExpirationDurationUnit` 'days' | 'months' | 'years', nullable, required — Only applicable for SUBSCRIPTION. When should the extra limits / package expire after rolling over. Only used when usageLimitRolloverEnabled=true
    - `startDate` string, date-time, nullable, required — Explicit start date for memberships that have specific duration
    - `endDate` string, date-time, nullable, required — Explicit end date for memberships that have specific duration
    - `featured` boolean, required — Indicates that membership should be featured on checkout
    - `priceType` 'fixed-price' | 'dynamic', required
    - `price` number, nullable, required — Membership price for FIXED priceType
    - `minimumPrice` number, nullable, required — Minimum membership price for DYNAMIC priceType
    - `maximumPrice` number, nullable, required — Maximum membership price for DYNAMIC priceType
    - `recommendedPrice` number, nullable, required — Recommended membership price for DYNAMIC priceType
    - `priceIncludesTax` boolean, required — Indicates if tax is already included in the price
    - `taxRateInPercent` number, nullable, required — Tax rate in percents
    - `freeTrialPrice` number, required — Free trial price
    - `tags` HostTagDto[], required
      - `id` integer, required
      - `name` string, required
      - `isCustomerBadge` boolean, required
      - `badgeLabel` string, nullable, required
      - `badgeColor` string, nullable, required
      - `corporateTagId` integer, nullable, required

---

[API](https://skmtc.net/momence/apis/momence-public.md) · [All operations](https://skmtc.net/momence/apis/momence-public/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/momence/momence-public/revisions/5e27e54ff467/schema)