User authentication and session management for B2B integrations
- Get a List of Membership Types by ID
Get Client Memberships
Get User Memberships
Get a List of Memberships by Filter
Get a List of Available Membership Types
Search available subscriptions for event
Check membership availability for event
Get client gift cards
Get user gift cards
Get a List of Gift Card Types by ID
Get a List of Available Gift Card Types
Get a List of Membership...
Business Management (1.0.0)
Full-featured B2B API for business operations.
Base URL: https://api.alteg.io/api
V1 will be gradually deprecated. We recommend using V2 API for new integrations. V1 endpoints are maintained for backward compatibility, but new features will be released in V2 only.
Download OpenAPI description
Overview
Languages
Servers
Mock server
https://developer.alteg.io/_mock/en/b2b-v1/openapi
Production
https://api.alteg.io/api/v1
- Mock serverhttps://developer.alteg.io/_mock/en/b2b-v1/openapi/chain/{chain_id}/loyalty/abonements
- Productionhttps://api.alteg.io/api/v1/chain/{chain_id}/loyalty/abonements
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
'https://developer.alteg.io/_mock/en/b2b-v1/openapi/chain/123/loyalty/abonements?created_after=2026-09-21T23%3A00%3A00.000-05%3A00&created_before=2026-09-21T23%3A00%3A00.000-05%3A00&abonements_ids=0&page=1&count=25' \
-H 'Accept: string' \
-H 'Authorization: Bearer <YOUR_Bearer {PartnerToken}_HERE>' \
-H 'Content-Type: string'Response
application/json
[ { "success": true, "data": [ … ], "meta": { … } } ]
Request
A list of membership types available at a location can be obtained by querying the location ID and membership type IDs.
The list is an array of membership types.
- Parameters
- company_id (required, number) - location ID
- id: 1 (optional, number) - membership type ID (you can specify several additional parameters
&ids[]={id}
Security
BearerPartnerUser
- Mock serverhttps://developer.alteg.io/_mock/en/b2b-v1/openapi/company/{location_id}/loyalty/abonement_types/fetch
- Productionhttps://api.alteg.io/api/v1/company/{location_id}/loyalty/abonement_types/fetch
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
'https://developer.alteg.io/_mock/en/b2b-v1/openapi/company/{location_id}/loyalty/abonement_types/fetch?ids%5B%5D=0' \
-H 'Accept: application/vnd.api.v2+json' \
-H 'Authorization: Bearer <YOUR_Bearer {PartnerToken}, User {UserToken}_HERE>' \
-H 'Content-Type: string'OK
Array with data objects
Example: [{"id":12233,"salon_group_id":123,"title":"Subscription with the possibility of freezing for 14 days","period":0,"period_unit_id":0,"allow_freeze":true,"freeze_limit":14,"is_allow_empty_code":false,"is_united_balance":false,"united_balance_services_count":0},{"id":255789,"salon_group_id":456,"title":"Subscription for 6 months","period":6,"period_unit_id":3,"allow_freeze":false,"freeze_limit":0,"is_allow_empty_code":false,"is_united_balance":false,"united_balance_services_count":0}]
Response
application/json
{ "success": true, "data": [ { … } ], "meta": { "count": 1 } }
Request
A list of membership types available at a location can be obtained by requesting the location ID. The list can be filtered by membership type name by passing the title parameter. Pagination is supported, specified by the page and page_size parameters.
The list is an array of membership types.
Membership type has the following structure:
| Field | Type | Description |
|---|---|---|
| id | number | Membership type identifier |
| title | string | Membership type name |
| allow_freeze | boolean | Is it possible to freeze memberships? true - allowed, false - not allowed |
| freeze limit | number | Maximum total freezing period (days) |
| salon_group_id | number | Identifier of the chain in which the membership type is valid |
| period | number | Membership expiration date (0 if not set) |
| period_unit_id | number | Membership expiration unit (list of possible values, if not set - 0) |
| 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 | number | Number of visits for total balance |
Measurement units of membership type validity period
| Meaning | Description |
|---|---|
| 1 | Day |
| 2 | Week |
| 3 | Month |
| 4 | Year |
Security
BearerPartnerUser
- Mock serverhttps://developer.alteg.io/_mock/en/b2b-v1/openapi/company/{location_id}/loyalty/abonement_types/search
- Productionhttps://api.alteg.io/api/v1/company/{location_id}/loyalty/abonement_types/search
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
'https://developer.alteg.io/_mock/en/b2b-v1/openapi/company/{location_id}/loyalty/abonement_types/search?title=string&page=0&page_size=0' \
-H 'Accept: application/vnd.api.v2+json' \
-H 'Authorization: Bearer <YOUR_Bearer {PartnerToken}, User {UserToken}_HERE>' \
-H 'Conetnt-Type: string'OK
Array with data objects
Example: [{"id":12233,"salon_group_id":123,"title":"Subscription with the possibility of freezing for 14 days","period":0,"period_unit_id":0,"allow_freeze":true,"freeze_limit":14,"is_allow_empty_code":false,"is_united_balance":false,"united_balance_services_count":0},{"id":255789,"salon_group_id":456,"title":"Subscription for 6 months","period":6,"period_unit_id":3,"allow_freeze":false,"freeze_limit":0,"is_allow_empty_code":false,"is_united_balance":false,"united_balance_services_count":0}]
Response
application/json
{ "success": true, "data": [ { … }, { … } ], "meta": { "count": 2 } }