Skip to content
/
Check membership availabi...

Business Management (1.0.0)

Full-featured B2B API for business operations.

Base URL: https://api.alteg.io/api

⚠️ Version Status

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.

Authentication

Requires both partner and user authorization:

Authorization: Bearer <partner_token>, User <user_token>
Download OpenAPI description
openapi.json
openapi.yaml
Overview
License
Altegio API Agreement
Terms of Service
Languages
Servers
Mock server
https://developer.alteg.io/_mock/en/b2b-v1/openapi/
Production
https://api.alteg.io/api/v1/

Authentication B2B

User authentication and session management for B2B integrations

Operations

Locations

Manage business locations (salons, clinics, etc.)

Operations

Services

Service catalog management including categories and team member assignments

Operations

Team Members

Staff management including positions and scheduling

Operations

Clients

Client database management with comments, files, and visit history

Operations

Users & Permissions

User account management and role-based access control

Operations

Appointments

Booking records and visit management

Operations

Events

Group events and class management

Operations

Schedule & Resources

Timetables, schedules, and resource allocation

Operations

Products

Product catalog and categories

Operations

Inventory

Stock management, storage operations, and tech cards

Operations

Sales

Sales transactions and document management

Operations

Payments

Payment processing, accounts, and KKM transactions

Operations

Notifications

SMS and email notifications to clients

Operations

Online Booking Settings

Configure online booking behavior and forms

Operations

Analytics & Reports

Business analytics, charts, and Z-reports

Operations

Tags

Label management for categorizing entities (deprecated, use v2)

Operations

Deposits

Client deposit accounts and operations

Operations

Loyalty Cards

Loyalty card types, issuance, and manual transactions

Operations

Subscriptions & Certificates

Membership subscriptions and gift certificates

Operations

Search available subscriptions for event

Request

Retrieves subscriptions that can be used to create a client schedule for a series of events.

This method returns subscriptions (memberships) that:

  • Belong to the specified client
  • Are valid and active
  • Can be applied to the specified activity
  • Have remaining visits available

Use cases:

  • Display available subscriptions when scheduling recurring activity sessions
  • Check which subscriptions cover specific activity types
  • Validate subscription applicability before creating schedules

Note: Returns subscriptions with their types and availability intervals.

Security
BearerPartner
Path
location_idintegerrequired

Location ID

Example: 720441
client_idintegerrequired

Client ID

Example: 146915197
Query
event_idintegerrequired

Event (group event) ID

Example: event_id=12345
Headers
Acceptstringrequired
Default application/vnd.api.v2+json
Content-Typestringrequired
Default application/json
Authorizationstringrequired

Bearer {partner_token}, User {user_token}

curl -i -X GET \
  'https://developer.alteg.io/_mock/en/b2b-v1/openapi/api/v1/company/720441/client/146915197/loyalty/abonements/search_for_activity?event_id=12345' \
  -H 'Accept: application/vnd.api.v2+json' \
  -H 'Authorization: Bearer <YOUR_Bearer {PartnerToken}_HERE>' \
  -H 'Content-Type: application/json'

Responses

List of available subscriptions

Bodyapplication/json
dataArray of objects
includedArray of objects

Related membership types and availability intervals

Response
application/json
{
  "data": [
    { … }
  ],
  "included": [
    {}
  ]
}

Check membership availability for event

Request

Validates a specific subscription for creating activity schedules.

Returns:

  • Last possible appointment date based on membership expiration
  • Available visit count for the selected subscription
  • Schedule day IDs that can be booked

Use cases:

  • Validate subscription before creating recurring appointments
  • Check if subscription has enough visits for schedule
  • Determine last bookable date based on expiration
  • Pre-validate schedule parameters

Note: Requires schedule_day_ids parameter to check specific dates.

Security
BearerPartner
Path
location_idintegerrequired

Location ID

Example: 720441
client_idintegerrequired

Client ID

Example: 146915197
membership_idintegerrequired

Membership instance ID

Example: 5248829
Query
event_idintegerrequired

Event (group event) ID

Example: event_id=12345
schedule_day_idsstringrequired

Comma-separated list of schedule day IDs to check

Example: schedule_day_ids=1,2,3,4,5
Headers
Acceptstringrequired
Default application/vnd.api.v2+json
Content-Typestringrequired
Default application/json
Authorizationstringrequired

Bearer {partner_token}, User {user_token}

curl -i -X GET \
  'https://developer.alteg.io/_mock/en/b2b-v1/openapi/api/v1/company/720441/client/146915197/loyalty/abonements/5248829/check_for_activity?event_id=12345&schedule_day_ids=1%2C2%2C3%2C4%2C5' \
  -H 'Accept: application/vnd.api.v2+json' \
  -H 'Authorization: Bearer <YOUR_Bearer {PartnerToken}_HERE>' \
  -H 'Content-Type: application/json'

Responses

Subscription availability information

Bodyapplication/json
dataobject
Response
application/json
{
  "data": {
    "id": "check_1",
    "type": "loyalty_abonement_check",
    "attributes": { … }
  }
}

Get client gift cards

Request

Returns a list of client gift cards by phone

AttributeTypeDescription
idintGift card ID
numberstringGift card code
balancedecimalCurrent balance
default_balancedecimalInitial balance
type_idintGift card type identifier
status_idintStatus ID
created_datetimestampDate of sale
expiration_datedatetimeBurn date
typeobjectObject with gift card type information
statusobjectAn object with information about the current gift card status

The type array contains the following objects:

AttributeTypeDescription
idintGift card type identifier
titlestringType name
balancedecimalGift card denomination
is_multibooleanIs it available for multiple debits
company_group_idintID of the chain where the certificate type was created
item_type_idintRestriction on the use of redemption points. 0 - no limit, 1 - services only, 2 - some services + all products, 3 - some services, 4 - products only
expiration_type_idintThe ID of the expiration limit. 0 - unlimited, 1 - fixed date, 2 - fixed term
expiration_datetimestampBurn date of all gift cards. Populated with expiration_type_id = 1
expiration_timeoutintValidity period of gift card. Populated with expiration_type_id = 2
expiration_timeout_unit_idintTime units. 1 - Day, 2 - Week, 3 - Month, 4 - Year
is_allow_empty_codebooleanSale without code
item_typeobjectObject with item_type_id and its name
Security
BearerPartner
Query
copmany_idnumberrequired

Location ID

phonenumberrequired

Customer phone number

Headers
Acceptstringrequired

application/vnd.api.v2+json

Content-Typestringrequired

application/json

Authorizationstringrequired

Bearer partner_token, User user_token

curl -i -X GET \
  'https://developer.alteg.io/_mock/en/b2b-v1/openapi/loyalty/certificates?copmany_id=0&phone=0' \
  -H 'Accept: string' \
  -H 'Authorization: Bearer <YOUR_Bearer {PartnerToken}_HERE>' \
  -H 'Content-Type: string'

Responses

OK

Bodyapplication/json
successboolean

Execution success status (true)

Example: true
dataArray of objects

Array of objects with data

Example: [{"id":409726,"number":888,"balance":9000,"default_balance":9000,"type_id":27841,"status_id":2,"created_date":"2026-09-21T23:00:00.000-05:00","expiration_date":"2026-09-21T23:00:00.000-05:00","type":{"id":27841,"title":"certificate 9000","balance":9000,"is_multi":true,"company_group_id":128284,"item_type_id":0,"expiration_type_id":2,"expiration_timeout":365,"expiration_timeout_unit_id":1,"is_allow_empty_code":false,"item_type":{"id":0,"title":"No limits"}},"status":{"id":2,"title":"activated"}}]
metaobject

Metadata (contains the number of certificates found)

Example: {"count":1}
Response
application/json
{
  "success": true,
  "data": [
    { … }
  ],
  "meta": {
    "count": 1
  }
}

Loyalty Programs

Discount programs, referral programs, and loyalty transactions

Operations

Salary

Staff salary calculations, payroll, and schemes

Operations

Notification Settings

Configure notification types and user preferences

Custom Fields

Custom field definitions for various entities

Operations

Chain Management

Multi-location chain operations and clients

Operations

Chain Loyalty Programs

Chain-level loyalty programs and transactions

Operations

Fiscalization

Tax system integration and KKM callbacks

Operations

Utilities

License info, phone validation, images, and tips

Operations