Skip to content
/
Generate payment link

Developer Tools (1.0.0)

APIs for partners building integrations with the Altegio platform. Base URL: https://api.alteg.io/api

Available Methods

Marketplace — Manage your marketplace applications: list connected locations, configure tariffs, handle billing, process installation/uninstallation callbacks. Webhooks — Configure event notifications for your integrations. Receive real-time updates when appointments, clients, or other entities change. VoIP Integration — Connect telephony systems to match incoming calls with client records and log call history. Dictionaries — Reference data for building forms and validations: countries, cities, business types.

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/developers/openapi/
Production
https://api.alteg.io/api/v1/

Marketplace

Marketplace application management, billing, and installation.

Operations

Set payment discount for locations

Request

Sets a payment discount for specific locations when they pay through Altegio platform.

Note: This endpoint is intended for marketplace partners only. Requires marketplace partner authorization.

Security
BearerPartner
Headers
Acceptstringrequired
Default application/vnd.api.v2+json
Content-Typestringrequired
Default application/json
Authorizationstringrequired

Bearer {partner_token}

Bodyapplication/jsonrequired
salon_idsArray of integersrequired

List of location IDs to apply discount

Example: [123,456]
application_idintegerrequired

Application ID from marketplace

Example: 123
discountnumber(float)required

Discount amount (percentage or fixed amount depending on configuration)

Example: 15.54
curl -i -X POST \
  https://developer.alteg.io/_mock/en/developers/openapi/marketplace/application/add_discount \
  -H 'Accept: application/vnd.api.v2+json' \
  -H 'Authorization: Bearer <YOUR_Bearer {PartnerToken}_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "salon_ids": [
      123,
      456
    ],
    "application_id": 123,
    "discount": 15.54
  }'

Responses

Discount successfully applied

Bodyapplication/json
successboolean
Example: true
dataobject
metaArray of arrays
Response
application/json
{
  "success": true,
  "data": {},
  "meta": []
}

Update notification channel availability

Request

Updates available notification channels for the application.

Note: Only for Chat Bots and SMS Aggregators category applications. For marketplace partners only.

Security
BearerPartner
Headers
Acceptstringrequired
Default application/vnd.api.v2+json
Content-Typestringrequired
Default application/json
Authorizationstringrequired

Bearer {partner_token}

Bodyapplication/jsonrequired
salon_idintegerrequired

Location ID

Example: 123
application_idintegerrequired

Application ID

Example: 456
channel_slugstringrequired

Channel to update availability for

Enum"sms""whatsapp"
Example: "sms"
is_availablebooleanrequired

Channel availability flag

Example: true
curl -i -X POST \
  https://developer.alteg.io/_mock/en/developers/openapi/marketplace/application/update_channel \
  -H 'Accept: application/vnd.api.v2+json' \
  -H 'Authorization: Bearer <YOUR_Bearer {PartnerToken}_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "salon_id": 123,
    "application_id": 456,
    "channel_slug": "sms",
    "is_available": true
  }'

Responses

Channel availability updated successfully

Bodyapplication/json
successboolean
Example: true
dataobject
metaArray of arrays
Response
application/json
{
  "success": true,
  "data": {},
  "meta": []
}

Webhooks

Event subscription and webhook configuration.

Operations

VoIP Integration

Telephony integration endpoints.

Operations

Dictionaries

Reference data (countries, cities, business types).

Operations