Skip to main content
GET
List outbound calls
Back to the Outbound Dialing API overview Paginated list of outbound calls for the project/environment, most recent first. Destinations are always masked. Combine filters freely; all supplied filters apply together (AND). The request needs the outbound_calls.read scope. Filter by channelConnectionId, phase, outcome, clientReferenceId, and a creation time window with from (inclusive) and to (exclusive). Page with limit (1 to 100, default 50) and cursor. Pass the nextCursor from the response as cursor to get the next page. It is null on the last page. To find calls by destination number, use Search outbound calls.

Authorizations

x-api-key
string
header
required

Project-bound Platform API key (abl_...). The key must carry outbound_calls.initiate for write operations (initiate, terminate) or outbound_calls.read for read operations (lookup, list, summary, search, event stream).

Path Parameters

projectSlug
string
required

The project's slug.

Minimum string length: 1
env
string
required

Deployment environment segment the call runs under, for example, production, staging, dev.

Minimum string length: 1

Query Parameters

channelConnectionId
string

Filter to calls placed through one channel connection.

Minimum string length: 1
phase
enum<string>

Filter by current lifecycle phase. Lifecycle phase, in order: accepted=submitted, not yet dialing; dialing=submitted to the carrier; ringing=destination is ringing; in_progress=answered, call is live; terminal=call has ended (see outcome).

Available options:
accepted,
dialing,
ringing,
in_progress,
terminal
outcome
enum<string>

Filter by terminal outcome. Only calls that have reached phase=terminal have one. How a terminal call ended. completed=ended normally after connecting; busy=destination was busy; rejected=destination actively declined/rejected the call; no_answer=rang without being picked up; machine=answering machine detected (only possible with amdMode other than off); failed=a hard failure prevented completion; canceled=terminated by a .../terminate call before it connected; expired=the call was abandoned before reaching a provider-reported outcome.

Available options:
completed,
busy,
rejected,
no_answer,
machine,
failed,
canceled,
expired
clientReferenceId
string

Filter to calls initiated with this caller-supplied reference.

Minimum string length: 1
from
string<date-time>

Inclusive ISO 8601 lower bound on call creation time.

to
string<date-time>

Exclusive ISO 8601 upper bound on call creation time.

limit
integer
default:50

Page size.

Required range: 1 <= x <= 100
cursor
string

Pass the previous response's nextCursor to get the next page.

Minimum string length: 1

Response

Page of matching calls.

success
boolean
required
data
object[]
required
nextCursor
string | null
required

Pass as cursor to fetch the next page. Null when there are no more results.