Skip to content
/
Set payment discount for...

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

Get application tariffs

Request

Retrieves list of tariffs for the application.

Note: For marketplace partners only.

Security
BearerPartner
Path
application_idintegerrequired

Application ID

Example: 123
Headers
Acceptstringrequired
Default application/vnd.api.v2+json
Authorizationstringrequired

Bearer {partner_token}

curl -i -X GET \
  https://developer.alteg.io/_mock/en/developers/openapi/marketplace/application/123/tariffs \
  -H 'Accept: application/vnd.api.v2+json' \
  -H 'Authorization: Bearer <YOUR_Bearer {PartnerToken}_HERE>'

Responses

Tariffs retrieved successfully

Bodyapplication/json
successboolean
Example: true
dataArray of objects

List of tariffs

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

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": []
}

Webhooks

Event subscription and webhook configuration.

Operations

VoIP Integration

Telephony integration endpoints.

Operations

Dictionaries

Reference data (countries, cities, business types).

Operations