List service codes

GET

/servicecode

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

OperationId:listServiceCodes

Returns service codes across domains. A service code is the value a user's service-code field names. Codes that start with system- are the platform's own, such as system-aa and system-queue. Name your own codes without that prefix.

What you get depends on your scope:

Super User and Super User Read Only get every domain's codes, and the system-wide ones, when domain is left out or *

Reseller gets the codes of the domains in its territory, without the system-wide ones

Office Manager and other scopes must send their own domain, or get 403

Add full=yes with a domain to include the system-wide codes. Filter with srvcode-code, srvcode-item, and srvcode-description. Each is an exact match.

Page with start and limit. limit defaults to 100. GET /servicecode/count returns the number of matching codes.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Query Params

Responses

🟢200OK

application/json

The matching service codes. An empty array when none match.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/servicecode?domain=example.com&srvcode-code=hotdesk&srvcode-item=*&srvcode-description=Hot%20desk%20user&full=yes&territory=example-reseller&fields=srvcode-code%2Csrvcode-description&sort=srvcode-code%20asc&start=undefined&limit=undefined' \
--header 'Authorization: Bearer <token>'

Response Example

200 - A domain with the system-wide codes (full=yes)

[
    {
        "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"
    },
    {
        "srvcode-code": "system-aa",
        "srvcode-item": "*",
        "domain": "*",
        "srvcode-description": "Auto Attendant"
    },
    {
        "srvcode-code": "system-queue",
        "srvcode-item": "*",
        "domain": "*",
        "srvcode-description": "Call Queue"
    }
]

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

Delete domain service code

Create service code