Retrieve All IP ACLs

GET

api

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

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

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

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

Show child attributes

objects

object[]

required

Show child attributes

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"
    }
  ]
}

​Query Parameters

​Response

​Examples

​cURL - Default Pagination

​cURL - Custom Pagination

Authorizations

Path Parameters

Response

Query Parameters

Response

Examples

cURL - Default Pagination

cURL - Custom Pagination