Retrieve All Trunks

List all SIP trunks for your account with pagination support.

This API retrieves a paginated list of all trunks associated with your account. Use this endpoint to view all your trunk configurations, monitor resource usage, and manage multiple trunks.

HTTP Request

GEThttps://api.vobiz.ai/api/v1/account/{account_id}/trunks

Authentication: Bearer token required. Include X-Auth-ID header.

Query Parameters

Request Parameters

Name	Type	Description
`limit`	integer	Number of results per page. Default: 20. Maximum: 100.
`offset`	integer	Number of results to skip for pagination. Default: 0. Use with limit for page navigation.

Response

Returns a paginated list of trunk objects with metadata about pagination state.

Response - 200 OK

{
                "meta": {
                  "limit": 10,
                  "offset": 0,
                  "total_count": 2
                },
                "objects": [
                  {
                    "trunk_id": "08c9431-fc2b-4a9e-997e-1b0fcd913565",
                    "account_id": "{Auth_ID}",
                    "name": "US Primary",
                    "trunk_domain": "08c9431.sip.vobiz.ai",
                    "trunk_status": "active",
                    "secure": false,
                    "trunk_direction": "both",
                    "concurrent_calls_limit": 20,
                    "cps_limit": 10,
                    "ipacl_uuid": "ip-acl-uuid-123",
                    "credential_uuid": "cred-uuid-123",
                    "primary_uri_uuid": "uri-uuid-123",
                    "fallback_uri_uuid": "uri-uuid-456",
                    "description": "Primary outbound trunk",
                    "inbound_destination": "5hj19p4hixv.sip.livekit.cloud",
                    "transport": "udp",
                    "created_at": "2025-10-17T11:18:06.869912Z",
                    "updated_at": "2025-10-28T10:15:09.12671Z"
                  },
                  {
                    "trunk_id": "22fed784-4ed9-4caf-8bbd-7738ca37f275",
                    "account_id": "{Auth_ID}",
                    "name": "US Primary",
                    "trunk_domain": "22fed784.sip.vobiz.ai",
                    "trunk_status": "active",
                    "secure": false,
                    "trunk_direction": "both",
                    "concurrent_calls_limit": 20,
                    "cps_limit": 10,
                    "ipacl_uuid": "ip-acl-uuid-789",
                    "credential_uuid": "cred-uuid-789",
                    "description": "Primary outbound trunk",
                    "inbound_destination": "5hj19p4hixv.sip.livekit.cloud",
                    "transport": "udp",
                    "created_at": "2025-10-17T11:17:46.06043Z",
                    "updated_at": "2025-10-27T11:31:21.799571Z"
                  }
                ]
              }

Examples

cURL - Default Pagination

cURL Request

curl -X GET "https://api.vobiz.ai/api/v1/account/{Auth_ID}/trunks" \
  -H "X-Auth-ID: YOUR_AUTH_ID" \
  -H "X-Auth-Token: YOUR_AUTH_TOKEN"

cURL - Custom Pagination

cURL Request

curl -X GET "https://api.vobiz.ai/api/v1/account/{Auth_ID}/trunks?limit=50&offset=0" \
  -H "X-Auth-ID: YOUR_AUTH_ID" \
  -H "X-Auth-Token: YOUR_AUTH_TOKEN"

Pagination Tip: Use total_count from the meta object to calculate total pages. For page 2 with limit 10, use offset=10.

Retrieve a Trunk

Update a Trunk