Freie Slots abrufen

Liefert freie Zeitfenster in einem Datumsbereich. Optional filterbar nach Zeitzone und User.

Erforderliche Header

Authorization: Bearer {{ token }}
Accept: application/json
Version: 2021-04-15 // Kalender/Termin-Version

URL-Parameter

Du musst die calendarId in der URL ersetzen.

# Beispiel-Aufruf
.../calendars/fu4y48c9PlUoyFxnCw2A/free-slots...

Query-Parameter (Erforderlich & Optional)

Ein Datumsbereich (max. 31 Tage) ist erforderlich. Zeitzone und User sind optional.

# ?startDate=... (Erforderlich)
# Zeitstempel in Millisekunden (z.B. 1729711200000)
startDate=1729711200000

# &endDate=... (Erforderlich)
# Zeitstempel in Millisekunden (z.B. 1730315999000)
endDate=1730315999000

# &timezone=... (Optional)
# IANA-Zeitzone (z.B. Europe/Berlin)
timezone=Europe/Berlin

# &userId=... (Optional)
# Filtert Slots für einen bestimmten Therapeuten
userId=15tDtK9qqUdfHTtrL5np

Request (cURL)

Ein vollständiger Beispiel-Request.

curl -L -G "https://services.leadconnectorhq.com/calendars/{calendarId}/free-slots" \
  -H "Authorization: Bearer {{ token }}" \
  -H "Version: 2021-04-15" \
  -H "Accept: application/json" \
  --data-urlencode "startDate=1729711200000" \
  --data-urlencode "endDate=1730315999000" \
  --data-urlencode "timezone=Europe/Berlin"

Mögliche Antworten (Response)

Antwort (200 OK): Freie Slots gefunden

Die Antwort listet die Slots, gruppiert nach Datum.

{
  "2025-10-24": {
    "slots": [
      "2025-10-24T10:00:00+02:00",
      "2025-10-24T10:15:00+02:00",
      "2025-10-24T10:30:00+02:00"
    ]
  },
  "2025-10-25": {
    "slots": [
      "2025-10-25T14:00:00+02:00",
      "2025-10-25T14:15:00+02:00"
    ]
  },
  "traceId": "f0d4f89e-8162-4327-bdc6-11e611b3cc35"
}