v1

latestOpenAPI 3.1.1Altegio API Agreement2026-08-062438211.0 KB
Online Booking

Get Dates Available for Booking

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
get/book_dates/{location_id}

Path parameters

location_idnumber required

location ID

Query parameters

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.

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.

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.

Headers

Acceptstring required

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

Content-Typestring required

application/json

Authorizationstring required

Bearer partner_token

Response

OK

successboolean

Execution success status (true)

metaobject[]

Metadata (empty array)

Example response

{
  "success": true,
  "data": {
    "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"
    ]
  },
  "meta": []
}