List domain address summaries

GET

/domains/{domain}/addresses/list

Last modified:2026-10-09 00:39:20

OperationId:ListDomainAddresses

Returns the same addresses as GET /domains/{domain}/addresses, with fewer fields. It uses the list privilege instead of the read privilege, so a scope that can list addresses but not read them can still pick one. Each row has only emergency-address-id, address-name, domain, user, address-city, and address-state-province-abbreviation. Append /list to a keyed path to read one address the same way.

It takes the same show_all_personal, address-name, caller-name, and start parameters. limit has no default here.

Requires Office Manager or Site Manager scope for your own domain, Reseller scope for the domains in your territory, or Super User scope. Site Manager scope is not limited to its own site here: it reaches every address in the domain. Super User Read Only scope can read.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Path Params

Query Params

Responses

🟢200OK

application/json

The addresses. An empty array when none match.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/domains//addresses/list?show_all_personal=yes&address-name=Office&caller-name=Front%20Desk&start=undefined&limit=100' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Address summaries

[
    {
        "emergency-address-id": "a-6525c1ae9d7ff",
        "address-name": "Main Office",
        "domain": "example.com",
        "user": "*",
        "address-city": "Example City",
        "address-state-province-abbreviation": "CA"
    },
    {
        "emergency-address-id": "a-6525c1ae9d800",
        "address-name": "Warehouse",
        "domain": "example.com",
        "user": "Main Office",
        "address-city": "Example City",
        "address-state-province-abbreviation": "CA"
    }
]

Modified at 2026-10-09 00:39:20

Count domain addresses

List user address summaries