API Documentation
Home > Total Uptime APIv2.0 Overview > Firewall > Access Control List (ACL) > Obtain the list of Access Control Group Entries

Obtain the list of Access Control Group Entries

Method:              GET
URI:                      /ALF/Firewall/AccessControl/{IPType}/{ACLID}/All?{options}

This method will return all Access Control Group Entries (specific allow/block rules) for the specific ACL ID requested.

The {IPType} is either “IPv4” or “IPv6”
The {ACLID} is the ID of the group which can be retrieved by obtaining the entire list of Access Control Groups

The {options} allow you to refine the results retrieved from the API. They must be formatted as a query string, e.g. if you use more than one, the 2nd one onwards should be preceded by an ampersand “&” character. The options include:

Parameters Description
perpage={value}
An integer for number of items you would like returned in this response. E.g. {20}
pageno={page} An integer for the page number (only applicable if the perpage is used). E.g. {1}
sortField={value} The field you wish to sort by. E.g. {Name}, {Method} etc.
sortOrder={value} The sort direction. E.g. {asc} or {desc}
searchField={value} The field you wish to search for. E.g. {Name}
searchString={value} The value you wish to search for. E.G. in the case of the search field being {Name} this could be {web farm} (note, a url encode the search string, e.g. a space must be %20 )
searchOper={value} This is a 2 letter code to specify how to use the search string:
bw = begins with
cn = contains
ew = ends with
eq = equal to
ne = not equal to

Sample CURL for retrieving all IPv4 Access Control Group Entries

curl -u username:password -X GET -H “Accept: application/json” “https://api.totaluptime.com/ALF/Firewall/AccessControl/{IPType}/{ACLID}/All”