Skip to content

Kursteilnehmer anzeigen ​

Gibt die Details einer einzelnen Kursteilnahme zurück.

Benötigte Lizenz

Dieser Endpoint erfordert die Kurs-Lizenz des Unternehmens.

Request ​

GET /api/oauth/v2/resource/courses/{uuid}/attendees/{attendeeUuid}

HeaderWert
AuthorizationBearer {access_token}

URL-Parameter ​

ParameterTypPflichtBeschreibung
uuidstringJaEindeutige Kurs-ID
attendeeUuidstringJaEindeutige Teilnahme-ID

Hinweis: Dieser Endpoint erfordert immer die Scopes courses, users und customers.

Hinweis: Eine stornierte Teilnahme liefert 200 OK – Stornierung ist die Löschform der Teilnahme, kein Grund für 404.

Response ​

Erfolg (200 OK) ​

json
{
  "data": {
    "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "course": "c3d4e5f6-a7b8-9012-cdef-012345678901",
    "customer": "f0e1d2c3-b4a5-6789-fedc-ba9876543210",
    "bookingDate": "2026-03-01T10:00:00+01:00",
    "deleted": false,
    "deletedAt": null,
    "deletedBy": null,
    "stornoReason": null,
    "cancelableUntil": "2026-02-28T10:00:00+01:00",
    "customerNotice": null,
    "billStatus": "open"
  }
}

Response-Felder ​

FeldTypBeschreibung
data.idstring (UUID) | nullEindeutige Teilnahme-ID. Bis zum Backfill null – ein Client, der einen String erwartet, muss null verkraften.
data.coursestring (UUID) | nullKurs. Nachladen über Kurs-Details
data.customerstring (UUID) | nullKunde. Nachladen über GET /customers/{uuid}
data.bookingDatestring (ISO 8601) | nullBuchungsdatum
data.deletedbooleantrue, wenn die Teilnahme storniert ist – Status ist entweder angemeldet oder storniert
data.deletedAtstring (ISO 8601) | nullZeitpunkt der Stornierung, null wenn nicht storniert
data.deletedBystring (UUID) | nullBenutzer, der die Teilnahme storniert hat. Nachladen über GET /users/{uuid}
data.stornoReasonstring | nullStornierungsgrund
data.cancelableUntilstring (ISO 8601) | nullLetzter Zeitpunkt für eine kostenlose Stornierung
data.customerNoticestring | nullNotiz zum Kunden bei dieser Teilnahme
data.billStatusstringAbrechnungsstatus: open, invoiced, ignore, unknown
Beispiele
bash
curl -X GET "https://my.offisy.at/api/oauth/v2/resource/courses/b2c3d4e5-f6a7-8901-bcde-f01234567890/attendees/b2c3d4e5-f6a7-8901-bcde-f01234567890" \
  -H "Authorization: Bearer {access_token}"
Parameter
Zuerst Token anfordern

Mögliche Fehler ​

StatusCodeBeschreibung
401invalid_clientUngültiger oder fehlender Access Token
403insufficient_scopeScope courses, users oder customers fehlt
403insufficient_scopeKurs-Lizenz nicht vorhanden
403access_deniedDer Kurs ist für den Besitzer-Benutzer deines API-Zugangs nicht lesbar
404not_foundKurs oder Teilnahme nicht gefunden, oder die Teilnahme gehört zu einem anderen Kurs

Offisy GmbH