List allowed IPs

GET

/ipaware/{hostname}/allowed_ips

Last modified:2026-10-09 00:59:30

OperationId:listAllowedIps

Lists the allow list on one server: every entry from every source, with the list's status. Addresses on the allow list are always allowed and never blocked by the firewall. Requires Super User or Admin Super User scope.

The request goes to the IP rules service on {hostname}, and its status and body come back unchanged. Errors the API decides itself use the code and message form; errors from the service use the error form.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Responses

🟢200OK

application/json

Allow-list status and entries.

Bodyapplication/json

🟠401Unauthorized

🟠403Forbidden

🟠429Too Many Requests

🔴503Service Unavailable

🟠404Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/ipaware//allowed_ips' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Allow list

{
    "status": {
        "builtinEntries": 2,
        "localEntries": 0,
        "dbEnabled": true,
        "dbEntries": 2,
        "dbTable": "nsipaware_allow",
        "lastDbSync": "2026-09-01T14:29:30.000Z",
        "lastDbError": null,
        "urlEnabled": false,
        "urls": [],
        "urlEntries": 0,
        "urlRefreshSec": 3600,
        "lastUrlSync": null,
        "lastUrlError": null,
        "vendorEntries": 0,
        "counters": {
            "added": 3,
            "removed": 1
        }
    },
    "entries": [
        {
            "cidr": "127.0.0.0/8",
            "source": "builtin",
            "comment": "loopback",
            "addedAt": null
        },
        {
            "cidr": "198.51.100.0/24",
            "source": "db",
            "comment": "Customer SBC",
            "addedBy": "admin@example.com key=jwt:3f9a",
            "country": "US",
            "city": "Phoenix",
            "domain": "example.com",
            "expiresAt": null
        },
        {
            "cidr": "203.0.113.7",
            "source": "db",
            "comment": "Temporary unblock",
            "addedBy": "admin@example.com key=jwt:3f9a",
            "country": null,
            "city": null,
            "domain": null,
            "expiresAt": "2026-09-01T15:30:00.000Z"
        }
    ]
}

Modified at 2026-10-09 00:59:30

Delete custom SMS carrier

Add allowed IPs