Skip to content

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

Example:staff_id=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": [], "12": [] }, "booking_dates": [ "2026-12-06", "2026-12-20", "2026-12-24", "2026-12-27", "2026-01-10" ], "working_days": { "1": [], "12": [] }, "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
{ "success": true, "data": { "booking_days": {}, "booking_dates": [], "working_days": {}, "working_dates": [] }, "meta": [] }