Place Voice Test Call

(v2)

POST

Places a test call to a voice connection, listens for its greeting, and returns the log of how the call went. The connection is marked verified when the agent answers and unverified otherwise. The request stays open for the length of the call.

POST/v2/voice-connections/{voiceConnectionId}/calls

curl -X POST "https://api.confident-ai.com/v2/voice-connections/{voiceConnectionId}/calls" \
  -H "CONFIDENT_API_KEY: <PROJECT-API-KEY>"

200

{
  "success": true,
  "data": {
    "id": "<VOICE-CONNECTION-LOG-ID>",
    "createdAt": "2026-10-08T16:40:00.000Z",
    "voiceConnectionId": "<VOICE-CONNECTION-ID>",
    "voiceConnectionName": "Support line",
    "source": "ping",
    "sourceName": "support-goldens",
    "testRunId": null,
    "transport": "PHONE",
    "address": "+14155550100",
    "status": "ANSWERED",
    "connectMs": 3200,
    "durationMs": 9400,
    "transcript": "Hi, thanks for calling. How can I help?",
    "error": null,
    "audioUrl": null
  },
  "link": "https://app.confident-ai.com/project/<PROJECT-ID>/voice-connections/<VOICE-CONNECTION-ID>",
  "deprecated": false
}

Headers

CONFIDENT_API_KEYstringRequired
The API key of your Confident AI project.

Path parameters

voiceConnectionIdstringRequired
The id of the voice connection.

Response

Place Voice Test Call succeeded.

successboolean
Indicates if the request was successful.
dataobject
A call placed to a voice connection.
Show 15 propertiesHide 15 properties
- idstring
  The id of the log.
- createdAtstring
  When the call started, as an ISO 8601 timestamp.
- voiceConnectionIdstring
  The id of the voice connection that was called.
- voiceConnectionNamestring
  The name of the voice connection when the call was placed.
- sourceenum
  What placed the call: ping for a test call, dataset_evaluation for a call made while evaluating a dataset.
  Show 2 enum valuesHide 2 enum values
  - ping
  - dataset_evaluation
- sourceNamestring
  The alias of the dataset that was evaluated, or an empty string for test calls.
- testRunIdstring | null
  The id of the test run the call belongs to, or null for test calls.
- transportenum
  How Confident AI reaches your voice agent: PHONE dials a phone number, SIP calls a SIP address directly, and WEBRTC joins a WebRTC session.
  Show 3 enum valuesHide 3 enum values
  - PHONE
  - SIP
  - WEBRTC
- addressstring
  The number, sip: address or URL that was called.
- statusenum
  How the call ended: ANSWERED when your agent picked up, NO_ANSWER when nobody picked up in time, FAILED when the call could not be placed.
  Show 3 enum valuesHide 3 enum values
  - ANSWERED
  - NO_ANSWER
  - FAILED
- connectMsnumber | null
  Milliseconds until your agent answered or the stream opened, or null when it never did.
- durationMsnumber
  How long the call lasted, in milliseconds.
- transcriptstring | null
  For test calls, what your agent said first. Null when nothing was transcribed.
- errorstring | null
  Why the call did not connect, or null when it did.
- audioUrlstring | null
  A signed URL to the call audio, valid for one hour: the greeting for test calls and the full recording for evaluation calls. Null when no audio was recorded.
linkstring
This is the URL of the resource on the Confident AI platform.
deprecatedboolean
Indicates if this endpoint is deprecated.

Built byConfident AI