For AI agents: markdown of this page — /docs-content-en/telephony/lines/voximplant.md documentation index — /llms.txt

Voximplant lines

GET /v1/voximplant-lines

Returns the list of lines rented from Voximplant or connected over SIP that are visible to your Bitrix24 account. Create, update, and delete operations are not available for these lines — read-only. Identifiers from this list can be passed as fromLine in outbound calls.

Examples

curl — personal key

Terminal 
curl "https://vibecode.bitrix24.com/v1/voximplant-lines" \
  -H "X-Api-Key: YOUR_API_KEY"

curl — OAuth application

Terminal 
curl "https://vibecode.bitrix24.com/v1/voximplant-lines" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN"

JavaScript — personal key

javascript 
const res = await fetch('https://vibecode.bitrix24.com/v1/voximplant-lines', {
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
  },
})

const { success, data } = await res.json()
console.log(`${data.length} lines available`)

JavaScript — OAuth application

javascript 
const res = await fetch('https://vibecode.bitrix24.com/v1/voximplant-lines', {
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
  },
})

const { success, data } = await res.json()

Response fields

Field Type Description
Fieldsuccess Typeboolean DescriptionAlways true on success
Fielddata Typearray DescriptionArray of lines
Fielddata[].id Typestring DescriptionLine identifier. The reg prefix means a number rented from Voximplant, sip means a connected SIP channel
Fielddata[].name Typestring DescriptionDisplay name

Response example

JSON 
{
  "success": true,
  "data": [
    {"id": "reg133788", "name": "test"},
    {"id": "reg150907", "name": "+12025550123"},
    {"id": "sip7", "name": "Office PBX 1"},
    {"id": "reg151083", "name": "Cloud PBX (9)"},
    {"id": "sip11", "name": "Office PBX (11)"},
    {"id": "reg151085", "name": "SIP line 2"}
  ]
}

Error response example

403 — no scope:

JSON 
{
  "success": false,
  "error": {
    "code": "SCOPE_DENIED",
    "message": "This endpoint requires 'telephony' scope"
  }
}

Errors

HTTP Code Description
HTTP401 CodeMISSING_API_KEY DescriptionThe X-Api-Key header was not provided
HTTP401 CodeINVALID_API_KEY DescriptionThe key is not recognized — no such key exists on the platform
HTTP401 CodeTOKEN_MISSING DescriptionThe key has no configured tokens
HTTP401 CodeKEY_INACTIVE DescriptionThe API key is inactive or revoked
HTTP403 CodeSCOPE_DENIED DescriptionThe key lacks the telephony scope
HTTP403 CodeBITRIX_ACCESS_DENIED DescriptionThe scope is present, but the key owner has no telephony administrator rights (line management) in Bitrix24
HTTP429 CodeRATE_LIMITED DescriptionRequest rate limit exceeded
HTTP502 CodeBITRIX_UNAVAILABLE DescriptionBitrix24 is unavailable
HTTP400 CodeUNSUPPORTED_FILTER DescriptionA filter parameter was passed, and this endpoint has none. The error text names what to use instead

Full list of common API errors — Errors.

Known specifics

Two line types by the id prefix. Identifiers reg<N> correspond to numbers rented from Voximplant; sip<N> to channels connected over SIP. Both types are accepted as fromLine in outbound calls.

Source for outbound calls. The fromLine parameter of the callback, auto-call, and auto-call-audio methods accepts both an id from this list and an application line number from GET /v1/telephony-lines. The choice depends on which line type the call goes through.

Telephony administrator rights required. The telephony scope on the key is not enough: the line list is returned only if the key owner (for vibe_app_ — the authorized user) has the telephony line management right in Bitrix24. Without it, the request returns 403 BITRIX_ACCESS_DENIED. The telephony line management right is granted by the Bitrix24 account administrator in the Bitrix24 telephony settings. The same rights model applies to call statistics — without telephony administrator rights the selection comes back empty. This is a Bitrix24 limitation, not Vibecode.

See also