License API
List Licenses
Licenses by Device
1min
This endpoint lets you list all licenses assigned to a specified device, regardless of license status.
Get a list of licenses assigned to a device
GET
Request
Query Parameters
hardware_id
required
String
Hardware ID of target device
Header Parameters
Date
required
String
eg. Thu, 17 Nov 2022 20:51:35 GMT
Authorization
required
String
See "License API authorization" for details
JS
Curl
1curl --location --request GET '/api/v4/device_licenses?hardware_id=STRING' \
2--header 'Accept: application/json' \
3--header 'Date: DATE_STRING' \
4--header 'Authorization: AUTHORIZATION_STRING'
5
Responses
200
400
1[
2 {
3 "id": 1702983098133459,
4 "order_store_id": "trial_1702983098133439",
5 "license_active": true,
6 "license_enabled": true,
7 "license_type": "subscription",
8 "license_key": "H62K-C35N-BS2J-VZ13",
9 "is_trial": true,
10 "max_license_users": 1,
11 "validity_period": "2023-12-20",
12 "enable_maintenance_period": false,
13 "maintenance_period": null,
14 "allow_grace_period": false,
15 "grace_period": 0,
16 "max_activations": 1,
17 "allow_unlimited_activations": true,
18 "times_activated": 1,
19 "start_date": null,
20 "transfer_count": 1,
21 "max_transfers": 0,
22 "allow_overages": false,
23 "max_overages": 0,
24 "is_floating_cloud": true,
25 "is_floating": false,
26 "floating_timeout": 120,
27 "can_borrow": false,
28 "max_borrow_time": 0,
29 "prevent_vm": false,
30 "custom_fields": [],
31 "product_features": [
32 {
33 "id": 1702983421931584,
34 "code": "e",
35 "name": "e",
36 "feature_type": "activation",
37 "expiry_date": null,
38 "metadata": {},
39 "is_floating": false,
40 "is_floating_cloud": false
41 }
42 ],
43 "customer": {
44 "email": "trial_request",
45 "company_name": null,
46 "reference": "",
47 "phone": "",
48 "first_name": null,
49 "last_name": null,
50 "city": "",
51 "postcode": "",
52 "state": "",
53 "country": "",
54 "address": "",
55 "customer_account": null,
56 "metadata": {}
57 },
58 "product_details": {
59 "product_id": 1584723961091040,
60 "product_name": "product1",
61 "short_code": "1337",
62 "authorization_method": "license-key",
63 "metadata": {}
64 },
65 "metadata": {},
66 "is_hardware_key_auth": false,
67 "is_air_gapped": false,
68 "floating_users": 1,
69 "trial_days": 1
70 },
71 {
72 "id": 1700060342999659,
73 "order_store_id": "trial_1700060342999639",
74 "license_active": false,
75 "license_enabled": true,
76 "license_type": "subscription",
77 "license_key": "H57Y-PS8L-VX6J-WU13",
78 "is_trial": true,
79 "max_license_users": 1,
80 "validity_period": null,
81 "enable_maintenance_period": false,
82 "maintenance_period": null,
83 "allow_grace_period": false,
84 "grace_period": 0,
85 "max_activations": 1,
86 "allow_unlimited_activations": false,
87 "times_activated": 0,
88 "start_date": null,
89 "transfer_count": 0,
90 "max_transfers": 0,
91 "allow_overages": false,
92 "max_overages": 0,
93 "is_floating_cloud": true,
94 "is_floating": false,
95 "floating_timeout": 120,
96 "can_borrow": false,
97 "max_borrow_time": 0,
98 "prevent_vm": false,
99 "custom_fields": [],
100 "product_features": [
101 {
102 "id": 1700060342999669,
103 "code": "ccc",
104 "name": "ccc",
105 "feature_type": "activation",
106 "expiry_date": null,
107 "metadata": {},
108 "is_floating": false,
109 "is_floating_cloud": true,
110 "floating_timeout": 120,
111 "floating_users": 1
112 }
113 ],
114 "customer": {
115 "email": "trial_request",
116 "company_name": null,
117 "reference": "",
118 "phone": "",
119 "first_name": null,
120 "last_name": null,
121 "city": "",
122 "postcode": "",
123 "state": "",
124 "country": "",
125 "address": "",
126 "customer_account": null,
127 "metadata": {}
128 },
129 "product_details": {
130 "product_id": 1584723961091040,
131 "product_name": "product1",
132 "short_code": "1337",
133 "authorization_method": "license-key",
134 "metadata": {}
135 },
136 "metadata": {},
137 "is_hardware_key_auth": false,
138 "is_air_gapped": false,
139 "floating_users": 1,
140 "trial_days": 1
141 }
142]


Updated 12 Dec 2024
Did this page help you?