Skip to content

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

Data About Locations Connected to the Application

Request

This endpoint retrieves a list of locations that have connected a specific application, along with detailed information about each.

Security
BearerPartner
Path
application_idnumberrequired

Application ID

Query
pagenumberrequired

Page number

countnumber<= 1000required

Number of elements per page

Headers
Acceptstringrequired

e.g. application/vnd.api.v2+json

Example: application/vnd.api.v2+json
curl -i -X GET \
  'https://developer.alteg.io/_mock/en/developers/openapi/marketplace/application/{application_id}/salons?page=0&count=1000' \
  -H 'Accept: application/vnd.api.v2+json' \
  -H 'Authorization: Bearer <YOUR_Bearer {PartnerToken}_HERE>'

Responses

Locations array

Bodyapplication/json
successboolean

Success status (true)

Example: true
dataArray of objects

Array of objects

Example: [{"id":1050,"title":"La Visage","public_title":"La Visage Beauty","short_descr":"Beauty saloon","logo":"https://app.alteg.io/images/no-master.png","active":1,"phone":"+13155550175","phones":["+13155550175"],"email":"info@lavisage.com","country_id":7,"schedule":"","country":"United States","city_id":181,"city":"New York","timezone":-5,"timezone_name":"America/New_York","address":"New York, 787 Jackson Drive","coordinate_lat":40.73061,"coordinate_lon":-73.935242,"phone_confirmation":true,"active_staff_count":2,"next_slot":"2026-03-23T10:10:00-05:00","app_ios":"","app_android":"","currency_short_title":"$","reminds_sms_disabled":false,"reminds_sms_default":1,"group_priority":900,"bookform_group_priority":0,"description":"<p>Welcome to La Visage</p>","photos":[],"booking_widget_promo":null}]
metaArray of objects

Metadata (empty array)

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

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