Nächste freie Zeitfenster

Gibt die nächsten verfügbaren Buchungszeitfenster für einen Standort und eine Leistung zurück. Durchsucht den konfigurierten Zeitraum und gibt die frühesten Ergebnisse sortiert nach Startzeit zurück.

Request

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

Header

Header	Wert
Authorization	Bearer {access_token}

Query-Parameter

Parameter	Typ	Pflicht	Beschreibung
locationId	string (UUID)	Ja	ID des Standorts
serviceId	string (UUID)	Ja	ID der Leistung
userId	string (UUID)	Nein	ID eines bestimmten Mitarbeiters (ohne: alle Mitarbeiter)
startDate	string (ISO 8601)	Nein	Startdatum der Suche (Standard: heute)
limit	integer	Nein	Anzahl der gewünschten Zeitfenster (Standard: 5, max. 20)
maxDays	integer	Nein	Maximaler Suchzeitraum in Tagen (Standard: 31, max. 31)

Erforderlicher Scope: appointments

Hinweis: Die API durchsucht den gesamten Zeitraum von startDate bis startDate + maxDays Tage und gibt die frühesten limit Ergebnisse zurück, sortiert nach Startzeit. Wird kein userId angegeben, werden alle verfügbaren Mitarbeiter für die Standort-Leistungs-Kombination durchsucht.

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",
        "...": "..."
      },
      "start": "2026-04-02T09:00:00+02:00",
      "end": "2026-04-02T10:00:00+02:00"
    },
    {
      "user": {
        "id": "d4e5f6a7-b8c9-0123-def0-123456789abc",
        "firstName": "Thomas",
        "lastName": "Berger",
        "...": "..."
      },
      "location": {
        "id": "b2c3d4e5-f6a7-8901-bcde-f01234567890",
        "name": "Ordination Wien",
        "...": "..."
      },
      "service": {
        "id": "c3d4e5f6-a7b8-9012-cdef-012345678901",
        "name": "Erstgespräch",
        "...": "..."
      },
      "start": "2026-04-02T10:30:00+02:00",
      "end": "2026-04-02T11:30:00+02:00"
    }
  ]
}

Response-Felder

Feld	Typ	Beschreibung
data[].user	object | null	Mitarbeiter (siehe Benutzer-Details)
data[].location	object	Standort (siehe Standort-Details)
data[].service	object	Leistung (siehe Leistung-Details)
data[].start	string (ISO 8601)	Startzeit des Zeitfensters
data[].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/next?locationId=b2c3d4e5-f6a7-8901-bcde-f01234567890&serviceId=b2c3d4e5-f6a7-8901-bcde-f01234567890&userId=b2c3d4e5-f6a7-8901-bcde-f01234567890&startDate=2026-04-15T10%3A00%3A00&limit=50&maxDays=14" \
  -H "Authorization: Bearer {access_token}"

Server

Client-ID

Client-Secret

Parameter

locationId *string

serviceId *string

userId string

startDate string

limit integer

maxDays integer

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