Read service code

GET

/servicecode/{type}/{code}

Last modified:2026-10-06 16:23:45

OperationId:readServiceCode

Returns one service code, addressed by its type and code, as an object. Send domain to read that domain's code.

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. Below Reseller scope, domain is required: without it the answer is 403.

Without domain, a Super User gets a matching code from any domain and a Reseller one from its territory. Which one is not defined. To read one domain's code exactly, use GET /domains/{domain}/servicecode/{type}/{code}.

Returns 404 when no code matches.

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 service code.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/servicecode/%2A/hotdesk?domain=example.com&full=yes&fields=srvcode-code%2Csrvcode-description' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Service code

{
    "srvcode-code": "hotdesk",
    "srvcode-item": "*",
    "domain": "example.com",
    "srvcode-description": "Hot desk user"
}

Modified at 2026-10-06 16:23:45

Unblock IP addresses

Update service code