Trunks
Retrieve a Trunk
Fetch full configuration of a single Vobiz SIP trunk by ID - rate limits, auth mode, SIP domain, and attached credentials, IP ACLs, and origination URIs.
GET
/
api
/
v1
/
Account
/
{auth_id}
/
trunks
/
{trunk_id}
Retrieve a trunk
curl --request GET \
--url https://api.vobiz.ai/api/v1/Account/{auth_id}/trunks/{trunk_id} \
--header 'X-Auth-ID: <api-key>' \
--header 'X-Auth-Token: <api-key>'import requests
url = "https://api.vobiz.ai/api/v1/Account/{auth_id}/trunks/{trunk_id}"
headers = {
"X-Auth-ID": "<api-key>",
"X-Auth-Token": "<api-key>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {'X-Auth-ID': '<api-key>', 'X-Auth-Token': '<api-key>'}
};
fetch('https://api.vobiz.ai/api/v1/Account/{auth_id}/trunks/{trunk_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"trunk_id": "11223344-1234-5678-90ab-cdef12345678",
"account_id": "MA_XXXXXXXX",
"name": "Acme Production Trunk",
"trunk_domain": "11223344-1234-5678-90ab-cdef12345678.sip.vobiz.ai",
"trunk_status": "active",
"secure": false,
"trunk_direction": "both",
"concurrent_calls_limit": 10,
"cps_limit": 2,
"description": "",
"transport": "udp",
"recording": false,
"enable_transcription": false,
"pii_redaction": false,
"webhook_method": "POST",
"recording_webhook_enabled": false,
"created_at": "2026-03-25T10:00:00Z",
"updated_at": "2026-03-25T10:00:00Z"
}GET https://api.vobiz.ai/api/v1/Account/{auth_id}/trunks/{trunk_id}
trunk_id. Use this endpoint to verify trunk configuration, check rate limits, or confirm the trunk’s enabled status.
Authentication required:
X-Auth-ID- Your account Auth IDX-Auth-Token- Your account Auth TokenContent-Type: application/json
Request
cURL
curl -X GET https://api.vobiz.ai/api/v1/Account/{auth_id}/trunks/bfab10fb-cb97-488b-9c63-989c32980b0f \
-H "X-Auth-ID: YOUR_AUTH_ID" \
-H "X-Auth-Token: YOUR_AUTH_TOKEN"
Response
Returns the complete trunk object with all attributes.Response - 200 OK
{
"trunk_id": "aabbccdd-1234-5678-90ab-cdef12345678",
"account_id": "MA_XXXXXXXX",
"name": "Acme Production Trunk",
"trunk_domain": "aabbccdd-1234-5678-90ab-cdef12345678.sip.vobiz.ai",
"trunk_status": "active",
"secure": false,
"trunk_direction": "both",
"concurrent_calls_limit": 10,
"cps_limit": 2,
"description": "",
"transport": "udp",
"recording": false,
"enable_transcription": false,
"pii_redaction": false,
"webhook_method": "POST",
"recording_webhook_enabled": false,
"created_at": "2026-05-12T05:11:52.054462Z",
"updated_at": "2026-05-12T05:11:52.054462Z"
}
Error Response (404): If the
trunk_id does not exist or does not belong to your account, the API returns a 404 Not Found error.Authorizations
Your Vobiz account Auth ID
Your Vobiz account Auth Token
Path Parameters
Your account Auth ID
Example:
"MA_XXXXXX"
Example:
"trunk_XXXXXX"
Response
200 - application/json
Trunk details
Was this page helpful?
⌘I
Retrieve a trunk
curl --request GET \
--url https://api.vobiz.ai/api/v1/Account/{auth_id}/trunks/{trunk_id} \
--header 'X-Auth-ID: <api-key>' \
--header 'X-Auth-Token: <api-key>'import requests
url = "https://api.vobiz.ai/api/v1/Account/{auth_id}/trunks/{trunk_id}"
headers = {
"X-Auth-ID": "<api-key>",
"X-Auth-Token": "<api-key>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {'X-Auth-ID': '<api-key>', 'X-Auth-Token': '<api-key>'}
};
fetch('https://api.vobiz.ai/api/v1/Account/{auth_id}/trunks/{trunk_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"trunk_id": "11223344-1234-5678-90ab-cdef12345678",
"account_id": "MA_XXXXXXXX",
"name": "Acme Production Trunk",
"trunk_domain": "11223344-1234-5678-90ab-cdef12345678.sip.vobiz.ai",
"trunk_status": "active",
"secure": false,
"trunk_direction": "both",
"concurrent_calls_limit": 10,
"cps_limit": 2,
"description": "",
"transport": "udp",
"recording": false,
"enable_transcription": false,
"pii_redaction": false,
"webhook_method": "POST",
"recording_webhook_enabled": false,
"created_at": "2026-03-25T10:00:00Z",
"updated_at": "2026-03-25T10:00:00Z"
}