--- title: "Get User Memberships" method: GET path: "/user/loyalty/memberships" tags: ["Client Personal Cabinet"] --- # Get User Memberships `GET /user/loyalty/memberships` ## Request - Base URL: `https://api.alteg.io/api/v1` - URL: `https://api.alteg.io/api/v1/user/loyalty/memberships` - Auth: HTTP bearer Returns a list of memberships of an authorized user ## Query parameters - `location_id` number, required ## Headers - `Accept` string, required - `Content-Type` string, required - `Authorization` string, required ## Response `200` OK - LoyaltyAbonementsResponseDataTypes: Get a list of customer memberships - `success` boolean: Execution success status (true) - `data` object[]: Array of objects with data - `id` integer: Membership ID - `number` string: Membership code - `balance_string` string: Service name, with number of uses - `is_frozen` boolean: Is the membership frozen? - `freeze_period` integer: The period the membership was frozen - `period` integer: Membership expiration value - `period_unit_id` integer: Identifier of the expiration units. 1 - day, 2 - week, 3 - month, 4 - year - `expiration_date` string, date-time, nullable: Membership expiration date - `created_date` string, date-time: Membership creation date; this is not necessarily the sale date. - `activated_date` string, date-time, nullable: Membership activation date - `is_united_balance` boolean: Whether membership has unified balance - `is_united_balance_unlimited` boolean: Whether unified balance is unlimited - `united_balance_services_count` integer: Number of services for unified balance - `goods_transaction_id` integer: Linked goods transaction ID, if present; use it to retrieve the sale document ID. A value of 0 does not establish a sale. - `slug` string: Membership type slug - `status` object: Current membership status - `id` integer: Status ID - `title` string: Status name - `extended_title` string: Full status name - `slug` string: Status slug - `category` string: Status category - `balance_container` object: An object that includes the links array with information about the membership balance - `links` object[]: Array of services covered by the membership - `count` integer: Number of applications - `is_unlimited` boolean: Whether count is unlimited - `service` object: Service details - `id` integer - `category_id` integer - `is_category` boolean - `title` string - `online_sale_title` string - `is_chain` boolean - `chain_price_min` number - `chain_price_max` number - `category` object - `category` object: Service category - `id` integer: Service ID - `category_id` integer: Service Category ID - `title` string: Service name - `is_category` boolean - `online_sale_title` string - `is_chain` boolean - `chain_price_min` number - `chain_price_max` number - `category` object - `type` object: Object with information about membership type - `id` integer: Membership type ID - `salon_group_id` integer: Identifier of the chain in which the membership type is valid - `title` string: Membership type name - `period` integer: Membership expiration date (0 if not set) - `period_unit_id` integer: Membership validity period unit (list of possible values, if not set - 0) - `allow_freeze` boolean: Is it possible to freeze memberships? true - allowed, false - not allowed - `freeze_limit` integer: Maximum total freezing period (days) - `freeze_limit_unit_id` integer: Freeze period unit: 1 = day, 2 = week, 3 = month, 4 = year - `is_booking_when_frozen_allowed` boolean: Allow booking when membership is frozen - `category_id` integer, nullable: Category ID restriction - `is_allow_empty_code` boolean: Allow the sale of a membership without a code? true - allow, false - do not allow - `is_united_balance` boolean: Total or separate membership balance: true - total, false - separate - `united_balance_services_count` integer: Number of visits for total balance - `is_united_balance_unlimited` boolean: Whether unified balance is unlimited - `slug` string: Membership type slug - `is_code_required` boolean: Whether activation code is required - `balance_edit_type_id` integer: Balance edit permission level - `cost` number: Current membership type price, not the historical amount paid for an individual membership. - `is_archived` boolean: Whether membership type is archived - `date_archived` string, date-time, nullable: Date when archived - `expiration_type_id` integer: Activation type: 1 = on sale, 2 = on first use, 3 = from specific date - `expiration_type_title` string: Human-readable expiration type - `service_price_correction` boolean: Whether service price can be adjusted - `is_online_sale_enabled` boolean: Whether online sale is enabled - `online_sale_title` string: Title for online sale - `online_sale_description` string: Description for online sale - `online_sale_price` number: Price for online sale - `autoactivation_time` integer: Time units for autoactivation - `autoactivation_time_unit_id` integer: Autoactivation time unit: 1 = days, 2 = weeks, 3 = months, 4 = years - `weight` integer: Sort order weight - `category` string: Membership type category - `balance_container` object: An object that includes the links array with information about the membership balance - `links` object[]: Array of services covered by the membership - `count` integer: Number of applications - `is_unlimited` boolean: Whether count is unlimited - `service` object: Service details - `id` integer - `category_id` integer - `is_category` boolean - `title` string - `online_sale_title` string - `is_chain` boolean - `chain_price_min` number - `chain_price_max` number - `category` object - `category` object: Service category - `id` integer: Service ID - `category_id` integer: Service Category ID - `title` string: Service name - `is_category` boolean - `online_sale_title` string - `is_chain` boolean - `chain_price_min` number - `chain_price_max` number - `category` object - `meta` object: Metadata (contains the number of memberships found) - `count` integer ## Other responses - `401`: Unauthorized - `403`: Forbidden - `404`: Not Found ## Changes - **2026-11-02** `5219afc665ea`: 1 info - endpoint added [Operation history](https://skmtc.dev/alteg/apis/online-booking/changes/user/loyalty/memberships/get.md) --- [API](https://skmtc.dev/alteg/apis/online-booking.md) - [All operations](https://skmtc.dev/alteg/apis/online-booking/llms.txt) - [OpenAPI document](https://skmtc.dev/alteg/apis/online-booking/revisions/5219afc665ea?raw)