Skip to content
/
Submit appointment review

Online Booking (1.0.0)

Public API for client-facing online booking integration. This API enables third-party developers to embed online booking functionality into external platforms such as business catalogs, branded apps, and partner services. Base URL: https://api.alteg.io/api

Authentication

All requests require partner authorization via Bearer token in the HTTP header: Authorization: Bearer <partner_token> To obtain a partner token, register in the Altegio Marketplace.

Rate Limits

  • 200 requests per minute per IP address - 5 requests per second per IP address
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/public/openapi/
Production server
https://api.alteg.io/api/v1/

Authentication

User authentication and verification endpoints for online booking

Operations

Online Booking

Endpoints for booking form, services, staff, availability, and appointment management

Operations

Client Personal Cabinet

Client account management and booking history

Operations

Get appointment review

Request

Security
BearerPartner
Path
record_tokenstringrequired

Short appointment token

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/public/openapi/master_record_review/{record_token}' \
  -H 'Accept: application/vnd.api.v2+json' \
  -H 'Authorization: Bearer <YOUR_Bearer {PartnerToken}_HERE>'

Responses

Returns data for displaying the feedback form and information about the status of submitting feedback and tips

Bodyapplication/json
successboolean

Execution success status (true)

Example: true
dataobject

Object with data

Example: {"favicon_url":"https://www.app.alteg.io/favicon.png","is_review_submitted":false,"page_title":"Leave feedback","master":{"id":58961,"name":"Alex Johnson","company_id":28939,"specialization":"Permanent Makeup, Artistic Tattoo","rating":5,"show_rating":1,"avatar":"https://www.app.alteg.io/uploads/masters/sm/20161014151227_5360.jpg","prepaid":"forbidden","position":{"id":2185,"title":"Master PM"}},"company":{"id":28939,"title":"\"Eyes-n-Lips\" New York","logo":"https://www.app.alteg.io/uploads/s_a6f66721046345a6226ac3040a57fb7d.jpg","address":"New York, 787 Jackson Drive"},"tips":[],"record":{"id":8219891,"payed_cost":2000,"date":"2026-08-11T15:00:00-0500"},"currency":{"id":1,"iso":"USD","name":"US Dollar","symbol":"USD","is_symbol_after_amount":true},"agreement_links":{"terms_of_use":"https://www.app.alteg.io/info/terms-of-use-review-tips","confidentiality_agreement":"https://www.app.alteg.io/info/confidential"},"language":{"id":1,"locale":"en-US","iso":"usa"}}
metaArray of objects

Metadata (empty array)

Example: []
Response
application/json
{
  "success": true,
  "data": {
    "favicon_url": "https://www.app.alteg.io/favicon.png",
    "is_review_submitted": false,
    "page_title": "Leave feedback",
    "master": { … },
    "company": { … },
    "tips": [],
    "record": { … },
    "currency": { … },
    "agreement_links": { … },
    "language": { … }
  },
  "meta": []
}

Submit appointment review

Request

Security
BearerPartner
Path
record_tokenstringrequired

Short appointment token

Headers
Acceptstringrequired

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

Example: application/vnd.api.v2+json
Bodyapplication/jsonrequired
ratinginteger(int32)required

Rating for the review (number of stars from 1 to 5)

Example: 5
textstring

Feedback text

Example: "Excellent service!"
tips_amountnumber(double)

Tip amount

Example: 22.5
redirect_prefixstring

The prefix part of the url that will be redirected to after returning from the payment form

Example: "https://n1.app.alteg.io"
curl -i -X POST \
  'https://developer.alteg.io/_mock/en/public/openapi/master_record_review/{record_token}' \
  -H 'Accept: application/vnd.api.v2+json' \
  -H 'Authorization: Bearer <YOUR_Bearer {PartnerToken}_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "rating": 5,
    "text": "Excellent service!",
    "tips_amount": 22.5,
    "redirect_prefix": "https://n1.app.alteg.io"
  }'

Responses

Review submitted successfully

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