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

Kurse abfragen

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

Liefert die Kurstermine eines Standorts in einem Zeitraum. Ohne Datumsangaben sind das die Kurse der nächsten 28 Tage ab heute. Ist der Aufruf mit einer Kundensitzung verbunden, wird die Antwort auf diesen Kunden abgestimmt.

Einen Platz in einem Kurs reservieren Sie anschließend mit Kursplatz reservieren.

Antwort

Ein JSON-Objekt mit der Liste courses, ein Eintrag je Kurstermin.

Fehlerfälle

StatusAntwortUrsache
404 {"result":"locationNotValid"} Der Standort existiert nicht, gehört nicht zu Ihrem Geschäft, oder Kurse sind für Ihr Geschäft nicht eingeschaltet.
400 {"result":"dateNotValid"} from oder until entspricht nicht dem Format TT.MM.JJJJ.

Parameter

NameÜbergabe
servicerGroupId Body Pflicht
Platzhalter{{servicerGroupId}} ID des Standorts.
from Body Optional
Beispiel02.01.2019 Erster Tag im Format TT.MM.JJJJ. Standard: heute.
until Body Optional
Beispiel31.01.2019 Letzter Tag (einschließlich) im Format TT.MM.JJJJ. Standard: 28 Tage nach from.
deals Body Optional
Beispielfalse true liefert nur Kurse mit Angebot (Deals). Standard: false.
locale Body Optional
Beispielde Sprache der Texte, z. B. "de", "en", "nl" oder "fr".
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

Have a question? Ask it here.

This manual is a service by belbo. Legal notice