Skip to main content
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>'
{
  "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
Returns a paginated list of all IP ACL entries associated with the account. Use this endpoint to view all whitelisted IP addresses, audit your IP access configuration, and manage multiple IP ACL entries.
Authentication required:
  • X-Auth-ID - Your account Auth ID
  • X-Auth-Token - Your account Auth Token
  • Content-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

FieldTypeRequiredDescription
limitintegerNoNumber of results per page. Default: 20. Maximum: 100.
offsetintegerNoNumber 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

​
X-Auth-ID
string
header
required

Your Vobiz account Auth ID

​
X-Auth-Token
string
header
required

Your Vobiz account Auth Token

Path Parameters

​
auth_id
string
required

Your account Auth ID

Example:

"MA_XXXXXX"

Response

200 - application/json

List of IP ACLs

​
meta
object
required
​
objects
object[]
required