Retrieve All IP ACLs

List all IP ACL entries for a trunk with pagination support.

This API retrieves 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.

Security Audit: Regularly review this list to ensure only authorized IP addresses are whitelisted. Remove any entries that are no longer needed.

HTTP Request

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

Authentication Required:

• X-Auth-ID: Your account ID (e.g., {Auth_ID})
• X-Auth-Token: Your account Auth Token
• Content-Type: application/json

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 IP ACL objects with metadata about pagination state.

Response - 200 OK

{
  "meta": {
    "limit": 20,
    "offset": 0,
    "total_count": 5
  },
  "objects": [
    {
      "id": "c1d2e3f4-a5b6-7890-cdef-1234567890ab",

      "ip_address": "203.0.113.50",
      "description": "Office static IP",
      "enabled": true,
      "created_at": "2025-01-15T10:40:15Z",
      "updated_at": "2025-01-15T10:40:15Z"
    },
    {
      "id": "d2e3f4a5-b6c7-8901-def1-234567890abc",

      "ip_address": "198.51.100.42",
      "description": "PBX server in data center",
      "enabled": true,
      "created_at": "2025-01-16T09:20:30Z",
      "updated_at": "2025-01-16T09:20:30Z"
    },
    {
      "id": "e3f4a5b6-c7d8-9012-ef12-34567890abcd",

      "ip_address": "192.0.2.100",
      "description": "Backup office IP",
      "enabled": false,
      "created_at": "2025-01-17T14:15:45Z",
      "updated_at": "2025-01-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_count 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 won't allow authentication. Checkupdated_at to see when entries were last modified.

Create IP ACL

Update IP ACL