List sites

Returns the domain's sites, 100 by default, sorted by name. A site is a system extension that holds settings for the users and call queues filed under it, such as dial plan, caller ID, time zone, and emergency address. The site's name is in site, and also in user for older clients.

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.

Page with start and limit. Use fields to return only the fields you name. The site name is always included. sort defaults to user asc. site returns only that site, with the shorter field set and live counts that GET /domains/{domain}/sites/{site} returns. billing=yes adds those counts to every site, at the cost of several queries per site.

When a site has no emergency address of its own, emergency-address-id is the domain's and emergency-address-source is domain_level. Credentials and identity fields of the site's extension, such as its voicemail PIN, are never returned.

Use GET /domains/{domain}/sites/count for a total, and GET /domains/{domain}/sites/list for a short form of every site. PUT and DELETE on this collection path return 405: address one site by name.

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/domains//sites?limit=undefined&start=undefined&sort=user%20desc&fields=site%2Cdial-plan%2Ctime-zone&site=Main%20Office&billing=yes' \ --header 'Authorization: Bearer <token>'

[ { "site": "Main Office", "user": "Main Office", "domain": "example.com", "name-first-name": "Main Office", "name-last-name": "Site", "login-username": "Main Office@example.com", "service-code": "system-site", "dial-plan": "example.com", "dial-policy": "US and Canada", "caller-id-name": "Example Main Office", "caller-id-number": "15555550100", "caller-id-number-emergency": "15555550100", "area-code": "555", "time-zone": "America/New_York", "language-token": "en_US", "limits-max-active-calls-total": "0", "limits-max-data-storage-kilobytes": "0", "ring-no-answer-timeout-seconds": "25", "emergency-address-id": "A1B2C3D4", "voicemail-enabled": "yes", "active-calls-total-current": 0, "created-datetime": "2026-09-01T14:30:00+00:00", "last-modified-datetime": "2026-09-01T14:30:00+00:00" } ]

Request

Responses