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}
Header
| Header | Wert |
|---|---|
Authorization | Bearer {access_token} |
URL-Parameter
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
uuid | string | Ja | Eindeutige Kurs-ID |
attendeeUuid | string | Ja | Eindeutige Teilnahme-ID |
Hinweis: Dieser Endpoint erfordert immer die Scopes
courses,usersundcustomers.
Hinweis: Eine stornierte Teilnahme liefert
200 OK– Stornierung ist die Löschform der Teilnahme, kein Grund für404.
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
| Feld | Typ | Beschreibung |
|---|---|---|
data.id | string (UUID) | null | Eindeutige Teilnahme-ID. Bis zum Backfill null – ein Client, der einen String erwartet, muss null verkraften. |
data.course | string (UUID) | null | Kurs. Nachladen über Kurs-Details |
data.customer | string (UUID) | null | Kunde. Nachladen über GET /customers/{uuid} |
data.bookingDate | string (ISO 8601) | null | Buchungsdatum |
data.deleted | boolean | true, wenn die Teilnahme storniert ist – Status ist entweder angemeldet oder storniert |
data.deletedAt | string (ISO 8601) | null | Zeitpunkt der Stornierung, null wenn nicht storniert |
data.deletedBy | string (UUID) | null | Benutzer, der die Teilnahme storniert hat. Nachladen über GET /users/{uuid} |
data.stornoReason | string | null | Stornierungsgrund |
data.cancelableUntil | string (ISO 8601) | null | Letzter Zeitpunkt für eine kostenlose Stornierung |
data.customerNotice | string | null | Notiz zum Kunden bei dieser Teilnahme |
data.billStatus | string | Abrechnungsstatus: 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
| Status | Code | Beschreibung |
|---|---|---|
| 401 | invalid_client | Ungültiger oder fehlender Access Token |
| 403 | insufficient_scope | Scope courses, users oder customers fehlt |
| 403 | insufficient_scope | Kurs-Lizenz nicht vorhanden |
| 403 | access_denied | Der Kurs ist für den Besitzer-Benutzer deines API-Zugangs nicht lesbar |
| 404 | not_found | Kurs oder Teilnahme nicht gefunden, oder die Teilnahme gehört zu einem anderen Kurs |