List user address summaries

GET

/domains/{domain}/users/{user}/addresses/list

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

OperationId:ListUserAddresses

Returns the same addresses as GET /domains/{domain}/users/{user}/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. The rows do not say which addresses are shared.

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

Basic User scope can call it for its own user, with ~ or its own extension. Office Manager and Site Manager scopes can call it for any user in their domain, Reseller scope for the domains in its territory, and Super User scope for any 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//users//addresses/list?show_only_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-6525c1ae9d801",
        "address-name": "Home office",
        "domain": "example.com",
        "user": "1001",
        "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"
    },
    {
        "emergency-address-id": "a-6525c1ae9d7ff",
        "address-name": "Main Office",
        "domain": "example.com",
        "user": "*",
        "address-city": "Example City",
        "address-state-province-abbreviation": "CA"
    }
]

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

List domain address summaries

Read voicemail reminders