Skip to main content
GET
cURL

Customer lookup

customerId is the customer reference ID you supplied when creating the customer, not a Finosu UUID. An unknown reference ID for your company returns 404.

Response

Returns all of the customer’s scheduled calls (any status) ordered by scheduledTime descending, newest first. Deleted entries are excluded. There is no pagination or status filter. status is one of PENDING, TASK_CREATED, PROCESSING, COMPLETED, FAILED, WILL_NOT_DO, SKIPPED_COMPLIANCE, SKIPPED_MANUAL, or CANCELLED. scheduledTime is an ISO 8601 timestamp with UTC offset. callId is null until a call is placed for the entry.

Authorizations

X-API-Key
string
header
required

Path Parameters

customerId
string
required

ID of customer

Response

Scheduled calls response

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.