Voice
Voice Call
Make an autonomous voice call with automatic objective analysis
POST
Overview
The Voice Call API enables AI agents to make autonomous phone calls. The OneShot Agent analyzes your objective, generates talking points, and conducts the call on your behalf.Authentication
Requires x402 payment. First call returns a quote (402), second call with payment executes.Request Body
string
required
What the call should accomplish. Minimum 10 characters. The OneShot Agent will analyze this to generate talking points and success criteria.
string | string[]
required
Phone number(s) in E.164 format (e.g.,
+14155551234). Multiple numbers triggers conference mode analysis.string
Personality and style for the OneShot Agent caller (e.g., “A polite assistant making a reservation”)
string
Additional context about the call situation
number
Maximum call duration (1-30 minutes). Default: 5
Quote Response (402)
The first request returns pricing and analysis:string
Quote ID to include in payment request
string
AI-generated summary of the call objective
string[]
Key points the OneShot Agent will cover during the call
string[]
How success will be evaluated
boolean
Whether this will be a conference call
string
Total cost in USD
Execution Response (202)
After payment, the call is initiated:string
Job ID for tracking call status
string
processing - call is in progressstring
The phone number making the call
string[]
Numbers being called
boolean
Whether this is a conference call
Completed Job Result
Poll/v1/requests/{request_id} for the result:
string
Full call transcript
string
AI-generated call summary
string
pass or fail based on success criterianumber
Actual call duration
number
Actual cost charged
Conference Calls
When multiple phone numbers are provided AND the objective suggests a multi-party call, conference mode is activated:- All parties are connected to a shared call
- The OneShot Agent moderates and facilitates the conversation
- A shared OneShot number is used (no phone registration fee)
Error Handling
string
Error code:
content_blocked, emergency_number_blocked, invalid_requestContent Blocked
Emergency Number Blocked
See Pricing for voice call costs. If a call fails (success_evaluation = “fail”), you’re charged at cost and credited the margin.