List site summaries

GET

/domains/{domain}/sites/list

Last modified:2026-10-08 23:11:25

OperationId:ListSitesInDomain

Returns every site in the domain with a short set of fields: the name in site and user, domain, name-first-name, name-last-name, directory-name-number-dtmf-mapping, and emergency-address-id.

Requires Office Manager, Site Manager, or Basic User in the domain, Reseller for a domain in your territory, or Super User or Super User Read Only. A Site Manager and a Basic User see every site in the domain, not only their own. Other scopes, and a Reseller outside its territory, get 403.

Unlike GET /domains/{domain}/sites, this has no default limit. Send start and limit to page. sort defaults to user asc. fields is ignored.

When a site has no emergency address of its own, emergency-address-id is the domain's and emergency-address-source is domain_level.

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

🟢200Success

application/json

Every site in the domain in the short form, possibly an empty array.

Bodyapplication/json

🟠401Authentication Required

🟠403Forbidden

🟠404Record not found

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/domains//sites/list?limit=25&start=undefined&sort=user%20desc' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Two sites

Short form. The second site has no address of its own and shows the domain's.

[
    {
        "site": "Main Office",
        "user": "Main Office",
        "domain": "example.com",
        "name-first-name": "Main Office",
        "name-last-name": "Site",
        "directory-name-number-dtmf-mapping": "",
        "emergency-address-id": "A1B2C3D4"
    },
    {
        "site": "Warehouse",
        "user": "Warehouse",
        "domain": "example.com",
        "name-first-name": "Warehouse",
        "name-last-name": "Site",
        "directory-name-number-dtmf-mapping": "",
        "emergency-address-id": "D5E6F7A8",
        "emergency-address-source": "domain_level"
    }
]

Modified at 2026-10-08 23:11:25

List user device summaries

List sites