Available Slots (Batch)

Returns available booking time slots for multiple users, locations, and services at once.

Request

GET /api/oauth/v2/resource/booking/available-slots/batch

Header

Header	Value
Authorization	Bearer {access_token}

Query parameters

Parameter	Type	Required	Description
userIds[]	string (UUID)	Yes	IDs of the users (multiple allowed)
locationIds[]	string (UUID)	Yes	IDs of the locations (multiple allowed)
serviceIds[]	string (UUID)	Yes	IDs of the services (multiple allowed)
startDate	string (ISO 8601)	Yes	Start date of the search (e.g. 2026-04-01)
endDate	string (ISO 8601)	No	End date of the search (default: startDate + 7 days)

Required scope: appointments

Note: The API returns a maximum of 50 time slots per combination. Combinations without an assigned service configuration are skipped.

Note: Each array parameter (userIds[], locationIds[], serviceIds[]) may contain at most 10 entries. The total number of combinations (users × locations × services) must not exceed 50.

Response

Success (200 OK)

{
  "data": [
    {
      "user": {
        "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "firstName": "Maria",
        "lastName": "Huber",
        "...": "..."
      },
      "location": {
        "id": "b2c3d4e5-f6a7-8901-bcde-f01234567890",
        "name": "Ordination Wien",
        "...": "..."
      },
      "service": {
        "id": "c3d4e5f6-a7b8-9012-cdef-012345678901",
        "name": "Erstgespräch",
        "...": "..."
      },
      "slots": [
        {
          "start": "2026-04-02T09:00:00+02:00",
          "end": "2026-04-02T10:00:00+02:00"
        }
      ]
    }
  ]
}

Response fields

Field	Type	Description
data[].user	object	User (see User Details)
data[].location	object	Location (see Location Details)
data[].service	object	Service (see Service Details)
data[].slots[].start	string (ISO 8601)	Start time of the slot
data[].slots[].end	string (ISO 8601)	End time of the slot

Note: Times are given in the company's local timezone with UTC offset.

Beispiele

bash

curl -X GET "https://my.offisy.at/api/oauth/v2/resource/booking/available-slots/batch?userIds%5B%5D=b2c3d4e5-f6a7-8901-bcde-f01234567890&locationIds%5B%5D=b2c3d4e5-f6a7-8901-bcde-f01234567890&serviceIds%5B%5D=b2c3d4e5-f6a7-8901-bcde-f01234567890&startDate=2026-04-15T10%3A00%3A00&endDate=2026-04-15T10%3A00%3A00" \
  -H "Authorization: Bearer {access_token}"

Server

Client-ID

Client-Secret

Parameter

userIds[] *string

locationIds[] *string

serviceIds[] *string

startDate *string

endDate string

Zuerst Token anfordern

Possible errors

Status	Code	Description
400	validation_error	Required parameter missing or UUID is invalid
401	invalid_client	Invalid or missing access token
403	insufficient_scope	Scope appointments not present
404	not_found	User, location, or service not found