belbo
  • Overview
  • API-Referenz
      • Abfrage der Standorte
      • Buchbare Standorte
      • Abfrage der Leistungen und Gruppen
      • Berechnung der Mitarbeiter zu Leistungen
      • Buchbare Mitarbeiter
      • Online buchbare Mitarbeiter eines Standorts
      • Abfrage des Warenkorbs
      • Zusatzdienstleistungen für gewählte Leistungen abfragen
      • Globale Zusatzleistungen abfragen
      • Abfrage von zusätzlichen Feldern (deprecated)
      • Mitarbeiterinformationsabfrage
      • Mitarbeitersuche mit Namen
      • Preisdetails für Leistung
      • Schrittweisen Buchungsprozess abfragen
      • Online verkaufbare Abos abfragen
      • Verfügbare Termine
      • Verfügbare Termine (JSON-Body)
      • Terminzeiten (auch bereits belegte)
      • Terminzeiten (JSON-Body)
      • Terminzeiten für mehrere Tage
      • Buchung starten (alt)
      • Buchung starten
      • Termin in einem Schritt buchen
      • Buchungsstatus abfragen
      • Abfrage des Warenkorbs für eine Buchung
      • Kundendaten zur Buchung hinzufügen
      • Abfrage Termin-spezifischer Felder
      • Terminspezifische Informationen speichern
      • Buchungsabschluss
      • Kurse abfragen
      • Kursplatz reservieren
      • Newsletterregistrierung
      • Gutscheinrestwertabfrage
      • Bewertungsabfrage
      • Abfrage der verkaufbaren Gutscheine
      • Automatische Online-Gutscheine abfragen
      • Token erhalten
      • Token auslesen
      • Sprache ändern
      • News
      • Standorte
      • Login
      • Login SHA-2
      • Logout
      • Fragenkatalog auslesen
      • Fragenkatalog auslesen mit Infos
      • Übergreifenden Fragenkatalog auslesen
      • Simple Registrierung
      • Registrierung
      • Registrierung bestätigen (optional)
      • Passwort vergessen
      • Passwort neu setzen (optional)
      • Push ID speichern
      • Passwort ändern
      • Benachrichtigungseinstellungen abfragen
      • Benachrichtigungseinstellungen ändern
      • Zukünftige Terminliste
      • Vergangene Termine
      • Termin absagen
      • Account löschen
      • Profilabfrage
      • Profiländerung
      • Mitarbeiter für Leistungen (deprecated)
      • Mitarbeiter für Leistungen
      • Verfügbare Tage
      • Tagesabfrage
      • Terminzeiten für einen Tag (deprecated)
      • Terminzeiten für einen Tag
      • Uhrzeit reservieren
      • Buchung abschließen
      • Arbeitszeiten abfragen
      • Arbeitszeiten erstellen
      • Arbeitszeiten ändern
      • Arbeitszeiten löschen
      • Arbeitszeiten, Abwesenheiten und Notizen eines Mitarbeiters abrufen
      • Mitarbeiter mit Pause blockieren
      • Terminänderung eines Tages abfragen
      • Termine für einen Tag abfragen
      • Daten für einen einzelnen Termin abfragen
      • Termine für einen Kunden abfragen
      • Kundentermin absagen
      • Mitarbeiter eines Termins ändern
      • Kundendaten zur Buchung hinzufügen (Geschützte API)
      • Rechnungen abfragen
      • Produktauflistung VK
      • Produktsuche
      • Leistungsauflistung gruppiert nach Produktgruppe
      • Leistungsauflistung
      • Gutscheinauflistung
      • Kassenstandsabfrage
      • Bestand an einem Verkaufsprodukt ändern
      • Kundensuche nach Mobilnummer
      • Kundenliste mit Mobilnummer
      • Kundenabfrage
      • Mitarbeiter
      • Kundendaten ändern
      • Zusatzfelder abfragen
Skip to content

API-Referenz › Public API › Kurse

Kursplatz reservieren

POST https://…/externalBooking/reserveCourseSeat
Diese Schnittstelle gehört zur Public API und liefert öffentlich sichtbare Daten – ein API-Schlüssel ist nicht nötig.

Reserviert einen Platz in einem Kurstermin. Die Reservierung ist zunächst ein Entwurf; sie wird mit denselben Schritten wie eine normale Buchung abgeschlossen. Dabei übergeben Sie bei jedem Schritt beide IDs aus der Antwort, appointmentId und appointmentParticipantId:

  1. Terminspezifische Informationen speichern (persistBasicData) – optional
  2. Kundendaten zur Buchung hinzufügen (persistCustomerData)
  3. Buchungsabschluss (finalizeBooking)

Ohne appointmentParticipantId würden diese Schritte nicht den reservierten Kursplatz, sondern den ersten Teilnehmer des Kurses bearbeiten.

Antworten

NameTypBeschreibung
OKDer Platz ist reserviert. Die Antwort enthält zusätzlich appointmentId und appointmentParticipantId.
FULLDer Kurs ist ausgebucht.

Fehlerfälle

StatusAntwortUrsache
404 {"result":"notfound"} Der Termin existiert nicht oder gehört nicht zu Ihrem Geschäft.
400 {"result":"noCourse"} Der Termin ist kein Kurstermin.

Parameter

NameÜbergabe
appointmentInternalId Body Pflicht
Beispiel51078854 Interne Termin-ID des Kurstermins.
callback Body Optional
Name einer JavaScript-Funktion. Ist er gesetzt, kommt die Antwort als JSONP (application/javascript) statt als JSON. Erlaubt sind nur Funktionsnamen wie "meineFunktion" oder "app.callback".

Struktur zuletzt mit der Postman-Collection abgeglichen: 02.11.2026

Beispielantworten

200 Platz reserviert
{
    "result": "OK",
    "appointmentId": "a8Kq3ZxP",
    "appointmentParticipantId": "m2Lw9TcR"
}
200 Kurs ausgebucht
{
    "result": "FULL"
}

Have a question? Ask it here.

This manual is a service by belbo. Legal notice