Skip to main content
GET
cURL
id is the scheduled call UUID returned by Create Scheduled Calls or List Scheduled Calls. In the response, customerId is your customer reference ID, status is one of PENDING, TASK_CREATED, PROCESSING, COMPLETED, FAILED, WILL_NOT_DO, SKIPPED_COMPLIANCE, SKIPPED_MANUAL, or CANCELLED, and callId is null until a call is placed for the entry.

Invalid Identifier

An invalid scheduled call UUID returns HTTP 422 Unprocessable Content with a string detail. A valid UUID with no matching record or no verifiable customer relationship returns 404; access to another company’s record returns 403.

Authorizations

X-API-Key
string
header
required

Path Parameters

id
string
required

ID of scheduled call to retrieve

Response

Scheduled call response

Scheduled call response model matching OpenAPI spec.

id
string
required

Identification number of the scheduled call

customerId
string
required

ID of the customer

scheduledTime
string
required

Scheduled time of the call

status
string
required

Status of the scheduled call

callId
string | null

Finosu call UUID, or null before a call is associated with this schedule.

postProcessingFlags
null

Currently always null. This endpoint exposes scheduling state, not call outcome flags. Use the configured call webhook flags field for delivered outcomes.