Skip to main content
POST
Search outbound calls by destination
Look up calls by the real (unmasked) destination number/SIP URI, without ever putting it in a URL. The destination is matched against a server-side blind index — the raw value in your request is never logged or echoed back; results still return the destination masked, like every other endpoint. The destination is optional — omit it to combine the other filters (phase, outcome, clientReferenceId, channelConnectionId, time window) as a general filtered search.

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, e.g. production, staging, dev.

Minimum string length: 1

Body

application/json
destination
object

Destination for the call — a phone number or a SIP URI.

channelConnectionId
string
Minimum string length: 1
phase
enum<string>

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>

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
Minimum string length: 1
from
string<date-time>
to
string<date-time>
limit
integer
Required range: 1 <= x <= 100
cursor
string
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.