Zum Inhalt springen
Hilfe-Center
Support kontaktierenApp öffnen

Anruf abrufen

GET
/v1/calls/{id}
curl --request GET \
--url https://api.speakki.de/v1/calls/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \
--header 'Authorization: Bearer <token>'

Ein Anruf mit Status und allen Versuchen.

Berechtigung: calls:read.

id
required
string format: uuid

ID des Anrufs.

Der Anruf.

Media typeapplication/json

Ein ausgehender Anruf (Auftrag) mit seinen Versuchen.

object
id
required

ID des Anrufs.

string format: uuid
status
required

queued wartet (auch zwischen zwei Versuchen), dialing klingelt, in_progress Gespräch läuft, completed Gespräch geführt, not_reached alle Versuche ohne Gespräch, canceled abgebrochen, blocked vor dem Wählen abgelehnt.

string
Allowed values: queued dialing in_progress completed not_reached canceled blocked
block_reason
required
Any of:
string
Allowed values: plan_required access_not_approved billing_blocked assistant_not_found assistant_outbound_disabled from_number_missing from_number_not_allowed invalid_number country_not_allowed special_number own_number suppressed contact_blocked outside_call_hours daily_limit_reached number_called_today missing_variables
to
required

Zielnummer in E.164.

string
from
required

Absendernummer in E.164.

string
assistant_id
required
Any of:
string format: uuid
campaign_id
required
Any of:
string format: uuid
variables
required

Werte für die Platzhalter in Begrüßung und Auftrag.

object
key
additional properties
string
metadata
required

Ihre freien Daten, unverändert zurückgegeben.

object
key
additional properties
scheduled_at
required
Any of:
string format: date-time
next_attempt_at
required
Any of:
string format: date-time
max_attempts
required

Versuche insgesamt, die für diesen Anruf erlaubt sind.

integer
attempt_count
required

Bisherige Wählversuche.

integer
last_result
required
Any of:
string
Allowed values: answered no_answer busy voicemail failed
created_at
required

Auftrag angelegt am.

string format: date-time
finished_at
required
Any of:
string format: date-time
attempts
required

Alle Wählversuche in ihrer Reihenfolge.

Array<object>

Ein Wählversuch.

object
number
required

Nummer des Versuchs, beginnend bei 1.

integer
result
required
Any of:
string
Allowed values: answered no_answer busy voicemail failed
started_at
required

Beginn des Wählens.

string format: date-time
ended_at
required
Any of:
string format: date-time
duration_seconds
required
Any of:
integer

Example

{
"id": "0b1d7c2e-6a0f-4d0b-9a55-2f4f8f1c7e10",
"status": "completed",
"block_reason": null,
"to": "+4915228817386",
"from": "+493023125010",
"assistant_id": "5e2a9c1b-7f43-4c1d-8b0a-3d9e6f2a1c44",
"campaign_id": null,
"variables": {
"name": "Frau Meier"
},
"metadata": {
"kundennummer": "4711"
},
"scheduled_at": null,
"next_attempt_at": null,
"max_attempts": 2,
"attempt_count": 1,
"last_result": "answered",
"created_at": "2026-11-16T09:00:00.000Z",
"finished_at": "2026-11-16T09:02:10.000Z",
"attempts": [
{
"number": 1,
"result": "answered",
"started_at": "2026-11-16T09:00:02.000Z",
"ended_at": "2026-11-16T09:02:10.000Z",
"duration_seconds": 118
}
]
}

Ungültige Anfrage.

Media typeapplication/json

Einheitliches Fehlerformat aller Antworten unter /v1.

object
error
required

Der Fehler.

object
code
required

Fester Code für Programme. Neue Codes können dazukommen, bestehende ändern sich nicht.

string
Allowed values: unauthorized insufficient_scope invalid_request not_found conflict rate_limited internal_error plan_required access_not_approved billing_blocked assistant_not_found assistant_outbound_disabled from_number_missing from_number_not_allowed invalid_number country_not_allowed special_number own_number suppressed contact_blocked outside_call_hours daily_limit_reached number_called_today missing_variables
message
required

Meldung für Menschen, auf Deutsch.

string
details

Zusatz je Code, z. B. fields bei invalid_request oder missing_variables bei missing_variables.

object
key
additional properties

Examples

Exampleinvalid_request
{
"error": {
"code": "invalid_request",
"message": "Die Anfrage ist ungültig."
}
}

API-Schlüssel fehlt oder ist ungültig.

Media typeapplication/json

Einheitliches Fehlerformat aller Antworten unter /v1.

object
error
required

Der Fehler.

object
code
required

Fester Code für Programme. Neue Codes können dazukommen, bestehende ändern sich nicht.

string
Allowed values: unauthorized insufficient_scope invalid_request not_found conflict rate_limited internal_error plan_required access_not_approved billing_blocked assistant_not_found assistant_outbound_disabled from_number_missing from_number_not_allowed invalid_number country_not_allowed special_number own_number suppressed contact_blocked outside_call_hours daily_limit_reached number_called_today missing_variables
message
required

Meldung für Menschen, auf Deutsch.

string
details

Zusatz je Code, z. B. fields bei invalid_request oder missing_variables bei missing_variables.

object
key
additional properties

Examples

Exampleunauthorized
{
"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.

Media typeapplication/json

Einheitliches Fehlerformat aller Antworten unter /v1.

object
error
required

Der Fehler.

object
code
required

Fester Code für Programme. Neue Codes können dazukommen, bestehende ändern sich nicht.

string
Allowed values: unauthorized insufficient_scope invalid_request not_found conflict rate_limited internal_error plan_required access_not_approved billing_blocked assistant_not_found assistant_outbound_disabled from_number_missing from_number_not_allowed invalid_number country_not_allowed special_number own_number suppressed contact_blocked outside_call_hours daily_limit_reached number_called_today missing_variables
message
required

Meldung für Menschen, auf Deutsch.

string
details

Zusatz je Code, z. B. fields bei invalid_request oder missing_variables bei missing_variables.

object
key
additional properties

Examples

{
"error": {
"code": "insufficient_scope",
"message": "Diesem API-Schlüssel fehlt die Berechtigung für diese Anfrage."
}
}

Nicht gefunden.

Media typeapplication/json

Einheitliches Fehlerformat aller Antworten unter /v1.

object
error
required

Der Fehler.

object
code
required

Fester Code für Programme. Neue Codes können dazukommen, bestehende ändern sich nicht.

string
Allowed values: unauthorized insufficient_scope invalid_request not_found conflict rate_limited internal_error plan_required access_not_approved billing_blocked assistant_not_found assistant_outbound_disabled from_number_missing from_number_not_allowed invalid_number country_not_allowed special_number own_number suppressed contact_blocked outside_call_hours daily_limit_reached number_called_today missing_variables
message
required

Meldung für Menschen, auf Deutsch.

string
details

Zusatz je Code, z. B. fields bei invalid_request oder missing_variables bei missing_variables.

object
key
additional properties

Examples

Examplenot_found
{
"error": {
"code": "not_found",
"message": "Nicht gefunden."
}
}

Zu viele Anfragen. retry-after und x-ratelimit-reset nennen die Sekunden, bis wieder Anfragen möglich sind.

Media typeapplication/json

Einheitliches Fehlerformat aller Antworten unter /v1.

object
error
required

Der Fehler.

object
code
required

Fester Code für Programme. Neue Codes können dazukommen, bestehende ändern sich nicht.

string
Allowed values: unauthorized insufficient_scope invalid_request not_found conflict rate_limited internal_error plan_required access_not_approved billing_blocked assistant_not_found assistant_outbound_disabled from_number_missing from_number_not_allowed invalid_number country_not_allowed special_number own_number suppressed contact_blocked outside_call_hours daily_limit_reached number_called_today missing_variables
message
required

Meldung für Menschen, auf Deutsch.

string
details

Zusatz je Code, z. B. fields bei invalid_request oder missing_variables bei missing_variables.

object
key
additional properties

Examples

Examplerate_limited
{
"error": {
"code": "rate_limited",
"message": "Zu viele Anfragen. Bitte versuchen Sie es gleich noch einmal."
}
}

Interner Fehler.

Media typeapplication/json

Einheitliches Fehlerformat aller Antworten unter /v1.

object
error
required

Der Fehler.

object
code
required

Fester Code für Programme. Neue Codes können dazukommen, bestehende ändern sich nicht.

string
Allowed values: unauthorized insufficient_scope invalid_request not_found conflict rate_limited internal_error plan_required access_not_approved billing_blocked assistant_not_found assistant_outbound_disabled from_number_missing from_number_not_allowed invalid_number country_not_allowed special_number own_number suppressed contact_blocked outside_call_hours daily_limit_reached number_called_today missing_variables
message
required

Meldung für Menschen, auf Deutsch.

string
details

Zusatz je Code, z. B. fields bei invalid_request oder missing_variables bei missing_variables.

object
key
additional properties

Examples

Exampleinternal_error
{
"error": {
"code": "internal_error",
"message": "Interner Fehler. Bitte versuchen Sie es später noch einmal."
}
}