Skip to main content
POST
Search outbound calls by destination
Back to the Outbound Dialing API overview 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. The request also accepts limit (1 to 100) and cursor, and returns the same page format as List outbound calls. The request needs the outbound_calls.read scope.

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

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.