Termine auflisten
const url = 'https://api.speakki.de/v1/appointments?status=planned';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://api.speakki.de/v1/appointments?status=planned' \ --header 'Authorization: Bearer <token>'Termine aus dem Kalender der Organisation, nach Beginn aufsteigend. Mit from und to grenzen Sie den Zeitraum ein.
Berechtigung: appointments:read.
Authorizations
Abschnitt betitelt „Authorizations“Parameters
Abschnitt betitelt „Parameters“Query Parameters
Abschnitt betitelt „Query Parameters“Beginn ab diesem Zeitpunkt (einschließlich).
Beginn vor diesem Zeitpunkt (ausschließlich).
Nur Termine in diesem Status.
Termine je Seite, 1 bis 100, Standard 25.
next_cursor der vorigen Seite.
Responses
Abschnitt betitelt „Responses“Eine Seite Termine.
Eine Seite Termine, nach Beginn aufsteigend.
object
Die Einträge dieser Seite.
Ein Termin aus dem Kalender der Organisation.
object
ID des Termins.
appointment Termin, callback_deadline Frist für einen Rückruf, other sonstiger Eintrag.
planned geplant, done erledigt, canceled abgesagt.
Titel des Termins.
Name, auf den der Termin läuft.
Notiz zum Termin.
Beginn des Termins.
Ende des Termins.
Angelegt am.
Zuletzt geändert am.
Für die nächste Seite als cursor senden. null = keine weitere Seite.
Example
{ "data": [ { "id": "e5b1d7a3-8c2f-4e6a-9d0b-3f7c1a5e8b42", "type": "appointment", "status": "planned", "title": "Heizungswartung", "customer_name": "Max Mustermann", "description": null, "starts_at": "2026-11-20T09:00:00.000Z", "ends_at": "2026-11-20T10:00:00.000Z", "service": { "id": "f2c4a6e8-1b3d-4f5a-8c7e-0a9b2d4f6e83", "name": "Wartung" }, "party_size": null, "contact_id": "a4d2c8e6-5f1b-4a3d-8c7e-9b0f2d4a6c81", "conversation_id": "c1a7e3f9-2b4d-4c6e-9f8a-0d3b5e7a9c21", "created_at": "2026-11-16T09:02:50.000Z", "updated_at": "2026-11-16T09:02:50.000Z" } ]}Ungültige Anfrage.
Einheitliches Fehlerformat aller Antworten unter /v1.
object
Der Fehler.
object
Fester Code für Programme. Neue Codes können dazukommen, bestehende ändern sich nicht.
Meldung für Menschen, auf Deutsch.
Zusatz je Code, z. B. fields bei invalid_request oder missing_variables bei missing_variables.
object
Examples
{ "error": { "code": "invalid_request", "message": "Die Anfrage ist ungültig." }}API-Schlüssel fehlt oder ist ungültig.
Einheitliches Fehlerformat aller Antworten unter /v1.
object
Der Fehler.
object
Fester Code für Programme. Neue Codes können dazukommen, bestehende ändern sich nicht.
Meldung für Menschen, auf Deutsch.
Zusatz je Code, z. B. fields bei invalid_request oder missing_variables bei missing_variables.
object
Examples
{ "error": { "code": "unauthorized", "message": "Der API-Schlüssel fehlt oder ist ungültig. Senden Sie ihn als „Authorization: Bearer spk_live_…“." }}Nicht erlaubt: Tarif, Freischaltung oder Berechtigung des Schlüssels.
Einheitliches Fehlerformat aller Antworten unter /v1.
object
Der Fehler.
object
Fester Code für Programme. Neue Codes können dazukommen, bestehende ändern sich nicht.
Meldung für Menschen, auf Deutsch.
Zusatz je Code, z. B. fields bei invalid_request oder missing_variables bei missing_variables.
object
Examples
{ "error": { "code": "insufficient_scope", "message": "Diesem API-Schlüssel fehlt die Berechtigung für diese Anfrage." }}{ "error": { "code": "plan_required", "message": "Ausgehende Anrufe sind ab dem Tarif Professional enthalten." }}Zu viele Anfragen. retry-after und x-ratelimit-reset nennen die Sekunden, bis wieder Anfragen möglich sind.
Einheitliches Fehlerformat aller Antworten unter /v1.
object
Der Fehler.
object
Fester Code für Programme. Neue Codes können dazukommen, bestehende ändern sich nicht.
Meldung für Menschen, auf Deutsch.
Zusatz je Code, z. B. fields bei invalid_request oder missing_variables bei missing_variables.
object
Examples
{ "error": { "code": "rate_limited", "message": "Zu viele Anfragen. Bitte versuchen Sie es gleich noch einmal." }}Interner Fehler.
Einheitliches Fehlerformat aller Antworten unter /v1.
object
Der Fehler.
object
Fester Code für Programme. Neue Codes können dazukommen, bestehende ändern sich nicht.
Meldung für Menschen, auf Deutsch.
Zusatz je Code, z. B. fields bei invalid_request oder missing_variables bei missing_variables.
object
Examples
{ "error": { "code": "internal_error", "message": "Interner Fehler. Bitte versuchen Sie es später noch einmal." }}