IP Access Control List
Retrieve All IP ACLs
Fetch a paginated list of all IP ACL entries on your Vobiz account to audit whitelisted IPv4 addresses, enabled states, and trunk IP auth coverage globally.
GET
/
api
/
v1
/
Account
/
{auth_id}
/
trunks
/
ip-acl
List IP ACLs
curl --request GET \
--url https://api.vobiz.ai/api/v1/Account/{auth_id}/trunks/ip-acl \
--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/ip-acl"
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/ip-acl', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"meta": {
"limit": 20,
"offset": 0,
"total": 3
},
"objects": [
{
"id": "11223344-1234-5678-90ab-cdef12345678",
"account_id": "MA_XXXXXXXX",
"ip_address": "10.20.30.0/24",
"description": "Office IP",
"enabled": true,
"created_at": "2026-03-25T10:00:00Z",
"updated_at": "2026-03-25T10:00:00Z"
},
{
"id": "99887766-1234-5678-90ab-cdef12345678",
"account_id": "MA_XXXXXXXX",
"ip_address": "192.168.1.0/24",
"description": "Datacenter ACL",
"enabled": true,
"created_at": "2026-03-22T09:00:00Z",
"updated_at": "2026-03-22T09:00:00Z"
},
{
"id": "55667788-1234-5678-90ab-cdef12345678",
"account_id": "MA_XXXXXXXX",
"ip_address": "203.0.113.0/24",
"description": "Production SBC",
"enabled": true,
"created_at": "2026-03-18T14:41:41Z",
"updated_at": "2026-03-18T14:41:41Z"
}
]
}GET https://api.vobiz.ai/api/v1/Account/{auth_id}/trunks/ip-acl
Authentication required:
X-Auth-ID- Your account Auth IDX-Auth-Token- Your account Auth TokenContent-Type: application/json
Security Audit: Regularly review this list to ensure only authorized IP addresses are whitelisted. Remove any entries that are no longer needed.
Query Parameters
| Field | Type | Required | Description |
|---|---|---|---|
limit | integer | No | Number of results per page. Default: 20. Maximum: 100. |
offset | integer | No | Number of results to skip for pagination. Default: 0. Use with limit for page navigation. |
Response
Returns a paginated list of IP ACL objects with metadata about pagination state.Response - 200 OK
{
"meta": {
"limit": 20,
"offset": 0,
"total": 3
},
"objects": [
{
"id": "aabbccdd-1234-5678-90ab-cdef12345678",
"account_id": "",
"ip_address": "192.168.0.0/16",
"description": "Office IP",
"enabled": true,
"created_at": "2026-03-18T14:41:41Z",
"updated_at": "2026-03-18T14:41:41Z"
},
{
"id": "bbccddee-2345-6789-01bc-def234567890",
"account_id": "",
"ip_address": "10.20.30.0/24",
"description": "Production SBC",
"enabled": true,
"created_at": "2026-04-02T09:20:30Z",
"updated_at": "2026-04-02T09:20:30Z"
},
{
"id": "ccddeeff-3456-789a-12cd-ef3456789012",
"account_id": "",
"ip_address": "10.40.50.0/24",
"description": "Datacenter ACL",
"enabled": false,
"created_at": "2026-04-15T14:15:45Z",
"updated_at": "2026-04-20T11:30:00Z"
}
]
}
Examples
cURL - Default Pagination
cURL Request
curl -X GET "https://api.vobiz.ai/api/v1/Account/{auth_id}/trunks/ip-acl" \
-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/ip-acl?limit=50&offset=0" \
-H "X-Auth-ID: YOUR_AUTH_ID" \
-H "X-Auth-Token: YOUR_AUTH_TOKEN"
Pagination Tip: Use
total from the meta object to calculate total pages. For page 2 with limit 20, use offset=20.Monitoring: Review the
enabled field for each entry. Disabled entries appear in the list but do not allow authentication. Check updated_at to see when entries were last modified.Authorizations
Your Vobiz account Auth ID
Your Vobiz account Auth Token
Path Parameters
Your account Auth ID
Example:
"MA_XXXXXX"
Was this page helpful?
⌘I
List IP ACLs
curl --request GET \
--url https://api.vobiz.ai/api/v1/Account/{auth_id}/trunks/ip-acl \
--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/ip-acl"
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/ip-acl', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"meta": {
"limit": 20,
"offset": 0,
"total": 3
},
"objects": [
{
"id": "11223344-1234-5678-90ab-cdef12345678",
"account_id": "MA_XXXXXXXX",
"ip_address": "10.20.30.0/24",
"description": "Office IP",
"enabled": true,
"created_at": "2026-03-25T10:00:00Z",
"updated_at": "2026-03-25T10:00:00Z"
},
{
"id": "99887766-1234-5678-90ab-cdef12345678",
"account_id": "MA_XXXXXXXX",
"ip_address": "192.168.1.0/24",
"description": "Datacenter ACL",
"enabled": true,
"created_at": "2026-03-22T09:00:00Z",
"updated_at": "2026-03-22T09:00:00Z"
},
{
"id": "55667788-1234-5678-90ab-cdef12345678",
"account_id": "MA_XXXXXXXX",
"ip_address": "203.0.113.0/24",
"description": "Production SBC",
"enabled": true,
"created_at": "2026-03-18T14:41:41Z",
"updated_at": "2026-03-18T14:41:41Z"
}
]
}