info@10duke.com

Query available licenses

You can query the licenses that are available for a user using the 10Duke Entitlement Management REST API.

This returns information on both the user’s personal licenses and the organization licenses they are authorized to use. The response only contains licenses that are currently valid.

API endpoint

10Duke Entitlement Management REST API endpoint:

Item URL (relative, prepend the environment base URL)
Query available licenses /users/{userId}/available-licenses

Request example

Send a POST request to /users/{userId}/available-licenses. See the API reference for details on the API path parameters, request body, and response schemas.

This example request uses curl (line breaks added for display purposes):

curl --request GET
   --url https://<your 10Duke Enterprise instance>/users/me/available-licenses

Response example

This sample response shows information that the response body can contain:

[{
   "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
   "validFrom": "2023-02-19T14:12:22.012Z",
   "validUntil": "2024-02-19T14:12:22.012Z",
   "active": true,
   "entitlementId": "79a605b5-f302-4c5d-bbc7-cbd58f1a9b0d",
   "licensedItem": {
      "id": "93f0b0cc-e848-4f8a-b0db-70da8e511234",
      "name": "CutXPro",
      "displayName": "CutXPro"
   },
   "licenseModelId": "9188e9b9-12fc-4882-91eb-d433650e42dc",
   "licenseModelName": "License_Model_Seats_based",
   "seatsTaken": 0,
   "seatsReserved": 0,
   "seatsTotal": 1,
   "seatCountCredits": [{
      "id": "3d969a10-4b61-4b93-9340-5bbc6220dda7",
      "validFrom": "2023-02-19T14:12:22.012Z",
      "validUntil": "2024-02-19T14:12:22.012Z",
      "active": true,
      "licenseId": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "licenseTransactionItemId": "4868fa9a-dccf-48d7-b789-767af81c37a0",
      "seatCount": 1,
      "seatsConsumed": 0
   }],
   "owner": {
      "id": "33e047a7-99bf-4ac5-8fea-b3d6f9d4ed1d",
      "name": "CustomerOrganization"
   }
}]