List domain service codes

GET

/domains/{domain}/servicecode

Last modified:2026-10-09 01:00:57

OperationId:listDomainServiceCodes

Returns the service codes of a domain. Add full=yes to include the system-wide codes, which every domain shares. The two together are the values a user's service-code can take in this domain. Codes that start with system- are the platform's own, such as system-aa and system-queue. Name your own codes without that prefix.

Requires Office Manager scope or above for your own domain, Reseller scope for the domains in your territory, or Super User scope for any domain. The read-only versions of those scopes can read.

Filter with srvcode-code, srvcode-item, and srvcode-description. Each is an exact match. Page with start and limit. limit defaults to 100. GET /domains/{domain}/servicecode/count returns the number of matching codes. Returns 404 when the domain does not exist.

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 matching service codes. 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//servicecode?srvcode-code=hotdesk&srvcode-item=*&srvcode-description=Hot%20desk%20user&full=yes&fields=srvcode-code%2Csrvcode-description&sort=srvcode-code%20asc&start=undefined&limit=undefined' \
--header 'Authorization: Bearer <token>'

Response Example

200 - The domain's own codes

[
    {
        "srvcode-code": "hotdesk",
        "srvcode-item": "*",
        "domain": "example.com",
        "srvcode-description": "Hot desk user"
    },
    {
        "srvcode-code": "lobby-phone",
        "srvcode-item": "*",
        "domain": "example.com",
        "srvcode-description": "Lobby phone"
    }
]

Modified at 2026-10-09 01:00:57

Count service codes

Create domain service code