List Voice Connections

(v2)

GET

Lists the voice connections in your Confident AI project one page at a time, ordered by name. Requires the Starter plan or above.

GET/v2/voice-connections

curl -X GET "https://api.confident-ai.com/v2/voice-connections" \
  -H "CONFIDENT_API_KEY: <PROJECT-API-KEY>"

200

{
  "success": true,
  "data": {
    "voiceConnections": [
      {
        "id": "<VOICE-CONNECTION-ID>",
        "projectId": "<PROJECT-ID>",
        "name": "Support line",
        "active": true,
        "config": {
          "transport": "PHONE",
          "phoneNumber": "+14155550100",
          "carrier": "CONFIDENT",
          "trunkUri": "sip:outbound@trunk.example.com",
          "trunkCredentials": {
            "username": "confident",
            "password": "YOUR-SIP-PASSWORD"
          },
          "callerId": "+14155550199"
        },
        "callSettings": {
          "maxConcurrentCalls": 1,
          "ringTimeoutS": 45,
          "maxCallDurationS": 1800,
          "silenceTimeoutS": 30,
          "recordCalls": true
        },
        "createdAt": "2026-10-01T09:12:00.000Z",
        "updatedAt": "2026-10-08T16:40:00.000Z"
      }
    ],
    "totalVoiceConnections": 2,
    "page": 1,
    "pageSize": 25
  },
  "link": "https://app.confident-ai.com/project/<PROJECT-ID>/voice-connections",
  "deprecated": false
}

Headers

CONFIDENT_API_KEYstringRequired
The API key of your Confident AI project.

Query parameters

pageintegerdefault: 1
The page to return. Defaults to 1.
pageSizeintegerdefault: 25
The number of results per page, at most 100. Defaults to 25.

Response

List Voice Connections succeeded.

successboolean
Indicates if the request was successful.
dataobject
One page of voice connections, with the total across all pages.
Show 4 propertiesHide 4 properties
- voiceConnectionslist of objects
  The voice connections for the current page, ordered by name.
  Show 8 propertiesHide 8 properties
  - idstring
    The id of the voice connection, generated by Confident AI.
  - projectIdstring
    The id of the project the connection belongs to.
  - namestring
    The name of the voice connection.
  - activeboolean
    Whether the last test call reached your agent. Changing config resets it to false.
  - configobject | object | object
    How Confident AI reaches your voice agent. transport decides which shape applies.
    Show 3 variantsHide 3 variants
    Phone Voice Configobject
    Dials your agent over the phone network.
    Show 6 propertiesHide 6 properties
    transportenum
    Show 1 enum valueHide 1 enum value
    PHONE
    phoneNumberstring
    The E.164 phone number to dial.
    carrierenum
    Who carries the call to the phone network: CONFIDENT uses Confident AI's own trunk, CUSTOM_TRUNK uses yours.
    Show 2 enum valuesHide 2 enum values
    CONFIDENT
    CUSTOM_TRUNK
    trunkUristring
    The sip: address of your outbound trunk. Required when carrier is CUSTOM_TRUNK.
    trunkCredentialsobject | null
    Digest credentials used to authenticate a SIP call.
    Show 2 propertiesHide 2 properties
    usernamestring
    The SIP digest username.
    passwordstring
    The SIP digest password.
    callerIdstring
    The number or sip: address presented to your agent as the caller. Leave it empty to use the default.
    OR
    SIP Voice Configobject
    Calls your agent's SIP address directly.
    Show 6 propertiesHide 6 properties
    transportenum
    Show 1 enum valueHide 1 enum value
    SIP
    sipUristring
    The sip: address of your agent.
    signalingTransportenum
    The transport used for SIP signaling. A ;transport= parameter on sipUri takes precedence.
    Show 3 enum valuesHide 3 enum values
    UDP
    TCP
    TLS
    credentialsobject | null
    Digest credentials used to authenticate a SIP call.
    Show 2 propertiesHide 2 properties
    usernamestring
    The SIP digest username.
    passwordstring
    The SIP digest password.
    callerIdstring
    The number or sip: address presented to your agent as the caller. Leave it empty to use the default.
    headerslist of objects
    Extra X- headers sent on the INVITE, for routing on your side.
    Show 2 propertiesHide 2 properties
    keystring
    The header name.
    valuestring
    The header value.
    OR
    WebRTC Voice Configobject
    Joins a WebRTC session with your agent.
    Show 6 propertiesHide 6 properties
    transportenum
    Show 1 enum valueHide 1 enum value
    WEBRTC
    providerenum
    Where your agent runs: LIVEKIT joins a LiveKit room, PIPECAT starts a Pipecat session, and CUSTOM posts an SDP offer to your own signaling URL.
    Show 3 enum valuesHide 3 enum values
    LIVEKIT
    CUSTOM
    PIPECAT
    urlstring
    The LiveKit server URL (wss://), the Pipecat start URL (https://), or your signaling URL (wss:// or https://).
    livekitobject
    LiveKit settings, read when provider is LIVEKIT.
    Show 3 propertiesHide 3 properties
    apiKeystring
    The LiveKit API key.
    apiSecretstring
    The LiveKit API secret.
    agentNamestring
    The LiveKit agent to dispatch into the room, if any.
    pipecatobject
    Pipecat settings, read when provider is PIPECAT.
    Show 2 propertiesHide 2 properties
    transportenum
    The transport your Pipecat agent runs on.
    Show 2 enum valuesHide 2 enum values
    DAILY
    WEBRTC
    apiKeystring
    The Pipecat Cloud API key, if any.
    headerslist of objects
    Headers sent to your signaling URL, read when provider is CUSTOM or PIPECAT.
    Show 2 propertiesHide 2 properties
    keystring
    The header name.
    valuestring
    The header value.
  - callSettingsobject
    Limits applied to every call placed to your agent.
    Show 5 propertiesHide 5 properties
    maxConcurrentCallsinteger
    The most calls placed to your agent at once.
    ringTimeoutSinteger
    Seconds to wait for your agent to answer, for PHONE and SIP.
    maxCallDurationSinteger
    Seconds after which a call is hung up.
    silenceTimeoutSinteger | null
    Seconds of silence from both sides after which a call is hung up, or null to never hang up for silence.
    recordCallsboolean
    Whether simulated calls are recorded.
  - createdAtstring
    When the connection was created, as an ISO 8601 timestamp.
  - updatedAtstring
    When the connection last changed, as an ISO 8601 timestamp.
- totalVoiceConnectionsinteger
  The total number of voice connections in this project.
- pageinteger
  The page this response covers.
- pageSizeinteger
  The number of voice connections per page.
linkstring
This is the URL of the resource on the Confident AI platform.
deprecatedboolean
Indicates if this endpoint is deprecated.

Built byConfident AI