Skip to content
/
Get Nearest Available Tim...

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

Get Team Members Available for Booking

Request

Each object from the array of team members available for booking has the following fields:

FieldTypeDescription
idnumberteam member ID
namestringteam member name
specializationstringteam member specialization
positionobjectteam member position
bookablebooleanDoes the team member have sessions available for booking
weightnumberteam member weight. When withdrawing, team members are sorted by weight, heavier first
show_ratingnumberWhether to show team member's rating (1 - show, 0 - don't show)
ratingnumberteam member rating
votes_countnumberNumber of votes rated team member
comments_countnumberNumber of comments to a team member
avatarstringPath to team member avatar file
informationstringAdditional information about the team member (HTML format)
session_datestringDate of the next day that there are available sessions (only for bookable = true)

The following filters are available:

  • service_ids: Array of service IDs. If you need team members who provide only the selected service
  • datetime: date (in iso8601 format). If you need team members who have sessions for the specified service at the specified time
Security
BearerPartner
Path
location_idnumberrequired

location ID

Example: 4564
Query
service_ids[]Array of numbers

Service ID. Filter by the list of service identifiers

datetimenumber

date in iso8601 format. Filter by service booking date (for example '2005-09-09T18:30')

Headers
Acceptstringrequired

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

Example: application/vnd.api.v2+json
Content-Typestringrequired

application/json

Authorizationstringrequired

Bearer partner_token

curl -i -X GET \
  'https://developer.alteg.io/_mock/en/public/openapi/book_staff/4564?service_ids%5B%5D=0&datetime=0' \
  -H 'Accept: application/vnd.api.v2+json' \
  -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":16,"name":"James","bookable":true,"specialization":"Paramedic","position":{"id":1,"title":"Administrator"},"show_rating":1,"rating":3,"votes_count":1,"avatar":"https://app.alteg.io/images/no-master.png","comments_count":0,"weight":11,"information":"<span></span>","seance_date":"2026-09-21","seances":[]},{"id":32,"name":"Peter","bookable":false,"specialization":"Therapist","position":{},"show_rating":1,"rating":4,"votes_count":1,"avatar":"https://app.alteg.io/images/no-master.png","comments_count":0,"weight":8,"information":"<span></span>"}]
metaArray of objects

Metadata (empty array)

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

Get Nearest Available Time Slots for Team Member

Request

the team member's nearest sessions object has the following fields:

FieldTypeDescription
session_datestringNext date with available sessions
sessionsarrayList of available sessions

The following filters are available:

  • service_ids: Array of service IDs. If you need sessions, when can you book these services
  • datetime: date (in iso8601 format) for which you want to get the next sessions
Security
BearerPartner
Path
location_idnumberrequired

location ID

team_member_idnumberrequired

team member ID

Query
service_ids[]Array of numbers

Service ID. Filter by the list of service identifiers

datetimenumber

date in iso8601 format. Filter by date

Headers
Acceptstringrequired

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

Example: application/vnd.api.v2+json
Content-Typestringrequired

application/json

curl -i -X GET \
  'https://developer.alteg.io/_mock/en/public/openapi/book_staff_seances/{location_id}/{team_member_id}?service_ids%5B%5D=0&datetime=0' \
  -H 'Accept: application/vnd.api.v2+json' \
  -H 'Authorization: Bearer <YOUR_Bearer {PartnerToken}_HERE>' \
  -H 'Content-Type: string'

Responses

OK

Bodyapplication/json
successboolean

Execution success status (true)

Example: true
dataobject

Object with data

Example: {"seance_date":"2026-09-21","seances":[{"time":"10:00","seance_length":3600,"sum_length":3600,"datetime":"2026-09-21T10:00:00-05:00"},{"time":"10:15","seance_length":3600,"sum_length":3600,"datetime":"2026-09-21T10:15:00-05:00"},{"time":"10:30","seance_length":3600,"sum_length":3600,"datetime":"2026-09-21T10:30:00-05:00"}]}
metaArray of objects

Metadata (empty array)

Example: []
Response
application/json
{
  "success": true,
  "data": {
    "seance_date": "2026-09-21",
    "seances": [ … ]
  },
  "meta": []
}

Get Dates Available for Booking

Request

The dates available for booking object has the following fields:

FieldTypeDescription
working_daysarray of working days grouped by monthWorking days of a team member/organization
working_datesarray of datesAn array of dates when the team member/organization works
booking_daysarray of days when there are free sessionsArray of days that are available for booking for the specified services
booking_datesarray of datesAn array of dates when there are free sessions for the service to the selected team member/organization

working days and booking_days have the same format: month:[array of days in this month]

For example, this booking_days: "9": [ "4", "5"] "10": [ "14", "25"] Means that on September 4 and 5, and on October 14 and 25 there are free sessions for booking

The following filters are available:

  • service_ids: Array of service IDs. If you need dates when you can book the specified services
  • staff_id: team member ID. If you need dates when you can book the specified team member
  • date: Date within a month, if you need dates for a specific month
Security
BearerPartner
Path
location_idnumberrequired

location ID

Query
service_ids[]string

Service ID. Filter by the list of service identifiers

staff_idnumber

team member ID. Filter by team member ID Default: 0

datestring

date in iso8601 format. Filter by month of booking.

Example: date=2026-09-01
date_fromstring

date in iso8601 format. Start of dates to search. Must be used together with the "date_to" param and overrides the "date" param.

Example: date_from=2026-09-01
date_tostring

date in iso8601 format. End of dates to search. Must be used together with the "date_from" param and overrides the "date" param.

Example: date_to=2026-09-30
Headers
Acceptstringrequired

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

Example: application/vnd.api.v2+json
Content-Typestringrequired

application/json

Authorizationstringrequired

Bearer partner_token

curl -i -X GET \
  'https://developer.alteg.io/_mock/en/public/openapi/book_dates/{location_id}?service_ids%5B%5D=string&staff_id=0&date=2026-09-01&date_from=2026-09-01&date_to=2026-09-30' \
  -H 'Accept: application/vnd.api.v2+json' \
  -H 'Authorization: Bearer <YOUR_Bearer {PartnerToken}_HERE>' \
  -H 'Content-Type: string'

Responses

OK

Bodyapplication/json
successboolean

Execution success status (true)

Example: true
dataobject

Data (object)

Example: {"booking_days":{"1":[10],"12":[6,20,24,27]},"booking_dates":["2026-12-06","2026-12-20","2026-12-24","2026-12-27","2026-01-10"],"working_days":{"1":[10],"12":[4,6,8,13,15,20,22,24,27,29]},"working_dates":["2026-12-04","2026-12-06","2026-12-08","2026-12-13","2026-12-15"]}
metaArray of objects

Metadata (empty array)

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

Client Personal Cabinet

Client account management and booking history

Operations