List license entries for a specific host

GET

/license/{hostname}

Last modified:2026-05-18 23:15:37

OperationId:listLicenseByHostname

Retrieve license records scoped to a specific cluster hostname. The hostname is resolved to an element_id via the element_domain table, then used to filter the license table. Returns an empty array if the hostname is not found. Requires Super User or Super User Read Only scope.

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

🟢200

application/json

List of license entries for the given hostname

Bodyapplication/json

🟠400

🟠401

🟠403

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/license/?license-product=undefined&license-status=undefined&license-update-status=undefined&limit=undefined&start=undefined&sort=undefined' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Success

{
    "license-element-id": "sipbx",
    "license-mac-address": "02:00:17:0D:5C:DC",
    "license-product": "NMS",
    "license-status": "active",
    "license-remaining-days": "365",
    "license-authorized-endpoints": "100",
    "license-authorized-sessions": "50",
    "license-update-status": "idle"
}

Modified at 2026-05-18 23:15:37

List license entries

List rejected SIP requests