Freie Zeitfenster (Batch) abrufen

Gibt verfügbare Buchungszeitfenster für mehrere Mitarbeiter, Standorte und Leistungen gleichzeitig zurück.

Request

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

Header

Header	Wert
Authorization	Bearer {access_token}

Query-Parameter

Parameter	Typ	Pflicht	Beschreibung
userIds[]	string (UUID)	Ja	IDs der Mitarbeiter (mehrere möglich)
locationIds[]	string (UUID)	Ja	IDs der Standorte (mehrere möglich)
serviceIds[]	string (UUID)	Ja	IDs der Leistungen (mehrere möglich)
startDate	string (ISO 8601)	Ja	Startdatum der Suche (z.B. 2026-04-01)
endDate	string (ISO 8601)	Nein	Enddatum der Suche (Standard: startDate + 7 Tage)

Erforderlicher Scope: appointments

Hinweis: Die API gibt maximal 50 Zeitfenster pro Kombination zurück. Kombinationen ohne zugeordnete Leistungskonfiguration werden übersprungen.

Hinweis: Jeder Array-Parameter (userIds[], locationIds[], serviceIds[]) darf maximal 10 Einträge enthalten. Die Gesamtzahl der Kombinationen (Mitarbeiter × Standorte × Leistungen) darf 50 nicht überschreiten.

Response

Erfolg (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-Felder

Feld	Typ	Beschreibung
data[].user	object	Mitarbeiter (siehe Benutzer-Details)
data[].location	object	Standort (siehe Standort-Details)
data[].service	object	Leistung (siehe Leistung-Details)
data[].slots[].start	string (ISO 8601)	Startzeit des Zeitfensters
data[].slots[].end	string (ISO 8601)	Endzeit des Zeitfensters

Hinweis: Die Zeiten sind in der lokalen Zeitzone des Unternehmens mit UTC-Offset angegeben.

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

Mögliche Fehler

Status	Code	Beschreibung
400	validation_error	Pflichtparameter fehlt oder UUID ist ungültig
401	invalid_client	Ungültiger oder fehlender Access Token
403	insufficient_scope	Scope appointments nicht vorhanden
404	not_found	Mitarbeiter, Standort oder Leistung nicht gefunden