List Scheduled Callbacks

get

https://api.talkdeskapp.com/schedule-callbacks

Returns a paginated list of scheduled callbacks with total count.
Use this endpoint to retrieve callbacks with optional filtering by status, phone number, agent, campaign, and time range.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Scope

schedule-callbacks:read

Query Params

page

integer

1 to 500

Defaults to 1

page

per_page

integer

1 to 500

Defaults to 1

per page

time_to_call

date-time

length ≤ 35

The time the callback is scheduled

phone_number

string

length ≤ 35

The phone number that is scheduled to be called.

contact_id

string

length ≤ 35

The id of the contact that is scheduled to be called.

record_id

string

length ≤ 36

The id of the record that is scheduled to be called.

status

string

length ≤ 35

The status of callback

next_time_to_call_end

date-time

length ≤ 35

End of next time to call when status is 'UNATTEMPTED' or 'TO_BE_RETRIED'

agent_id

string

length between 1 and 50

The assigned agent id of schedule callback. Return the callbacks which are specifically assigned to an agent (Myself only, Myself if available), or assigned to specific agents including her/him.
if want to filter by multiple agent id, agent_id=agent_id1,agent_id2

campaign_id

string

length ≤ 35

The campaign id of where the callback originates from.

start_time

date-time

length ≤ 35

Start of next time to call

end_time

date-time

length ≤ 35

End of next time to call

queue

string

length between 1 and 100

The queue name. To filter by multiple queues, use comma-separated values (for example, queue=queue1,queue2).

team_id

string

length between 1 and 100

The ids of team, if want to filter by multiple team, team_id=123,345

from_call_type

string

length ≤ 64

Describes what call type is this related to, if want to filter by multiple call type, from_call_type=INBOUND,MANUAL_OUTBOUND

Responses

Scope

200A paginated list of scheduled callbacks with the total count.

400Errors were found in the submitted data

401Unauthorized

403Forbidden