Activate Bundle (Online Method)

15min
Activates all licenses inside of a bundle. Returns the list of activated licenses in response
POST
Request
Header Parameters
Date
required
String
In RFC7231 format (see "License API Authorization"), eg.: Thu, 17 Nov 2022 20:51:35 GMT
Authorization
required
String
See "License API Authorization" article
Body Parameters
hardware_id
required
String
Unique hardware ID generated for some device
product
required
String
Product bundle short code
license_key
optional
String
Required if product is key_based. Attach the license key (eq. 1111-2222-3333-4444)
username
optional
String
Required if product is user based. Attach the assigned license user email (eq. [email protected])
password
optional
String
Required if product is user based. Attach the assigned license user password (eq. somepassword)
id_token
optional
String
Required if using SSO. Attach the id_token received from the SSO if Implicit grant authorization method is being used.
code
optional
String
Required if using SSO. Attach the code received from the SSO if Authorization code grant method is being used.
customer_account_code
optional
String
Required if using SSO. Attach the customer_account_code to which SSO provider is configured. 
license_id
optional
String
License ID of bundle license
is_vm
optional
Boolean
Set to true if using virtual machine
vm_info
optional
String
Optional virtual machine informations.
os_ver
optional
String
Version of the operating system.
hostname
optional
String
Device hostname
os_hostname
optional
String
Hostname of the OS ( check this before publishing! )
ip
optional
String
IP address
ip_local
optional
String
Local IP address ( check this before publishing! )
app_ver
optional
String
Version of the product application used with this license.
sdk_ver
optional
String
Version of the SDK used.
mac_address
optional
String
Device MAC address
variables
optional
Object
Device variables. Variables are sent as a JSON object where the key is the variable name, and the value is the value of the variable
Curl
Node.js
JS
Python
Ruby
import requests

url = "/api/v4/activate_bundle"

payload = "{\"hardware_id\":\"String\",\"product\":\"string\",\"license_key\":\"string\",\"username\":\"string\",\"password\":\"string\",\"id_token\":\"string\",\"code\":\"string\",\"customer_account_code\":\"string\",\"is_vm\":\"Boolean\",\"vm_info\":\"string\",\"os_ver\":\"string\",\"hostname\":\"string\",\"os_hostname\":\"string\",\"ip\":\"string\",\"ip_local\":\"string\",\"app_ver\":\"string\",\"sdk_ver\":\"string\",\"mac_address\":\"string\"}"
headers = {
   'Accept': 'application/json',
   'Date': 'string',
   'Authorization': 'string'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

import requests

url = "/api/v4/activate_bundle"

payload = "{\"hardware_id\":\"String\",\"product\":\"string\",\"license_key\":\"string\",\"username\":\"string\",\"password\":\"string\",\"id_token\":\"string\",\"code\":\"string\",\"customer_account_code\":\"string\",\"is_vm\":\"Boolean\",\"vm_info\":\"string\",\"os_ver\":\"string\",\"hostname\":\"string\",\"os_hostname\":\"string\",\"ip\":\"string\",\"ip_local\":\"string\",\"app_ver\":\"string\",\"sdk_ver\":\"string\",\"mac_address\":\"string\"}"
headers = {
   'Accept': 'application/json',
   'Date': 'string',
   'Authorization': 'string'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)
Responses
200
400
[
    {
        "customer": {
            "email": "[email protected]",
            "company_name": "",
            "reference": "00QJ6000001ipQ1MAI",
            "phone": "4554334",
            "first_name": "adfasd",
            "last_name": "fzdf",
            "city": "",
            "postcode": "",
            "state": "",
            "country": "HR",
            "address": "",
            "customer_account": null,
            "metadata": {}
        },
        "custom_fields": [],
        "product_features": [],
        "validity_period": null,
        "allow_grace_period": false,
        "grace_period": 0,
        "license_type": "perpetual",
        "license_key": "N9WG-RY5A-Q59M-2LB2",
        "is_trial": false,
        "active": false,
        "enable_maintenance_period": false,
        "maintenance_period": null,
        "max_activations": 1,
        "allow_unlimited_activations": false,
        "times_activated": 1,
        "allow_overages": false,
        "max_overages": 0,
        "prevent_vm": false,
        "is_floating_cloud": false,
        "is_floating": false,
        "floating_timeout": 120,
        "transfer_count": 0,
        "max_transfers": 0,
        "start_date": null,
        "product_details": {
            "product_id": 1586066454419525,
            "product_name": "test_bundle",
            "short_code": "b23",
            "allow_trial": true,
            "trial_days": 15,
            "authorization_method": "license-key",
            "allow_overages": false,
            "max_overages": 0,
            "prevent_vm": false,
            "validity_period": null,
            "floating_timeout": 120,
            "company_id": 276,
            "metadata": {}
        },
        "can_borrow": false,
        "max_borrow_time": 0,
        "device_id": 1733403637808059,
        "id": 1733403616622029,
        "metadata": {},
        "is_hardware_key_auth": false,
        "is_air_gapped": false,
        "license_signature": "raLoZyMSIuHbhum4y9L3JgBog5RwocCXvYWLtn4gt+GGxtoxed8WA57f4J1kz5PdUdZTrSs4vT5hWDiXIwDcr4tZ7fkxyH4nS55wDea61KaYsRmlDUbesgQbn1grVSL0AgfUnnxfav9AbTM0J5/UNPbw3F1ceFl26hMKv+3N67EoMSvjntyfop10BI/azbdgxr1sMF2jkPLztPFEgmrnkSEU1Vxs6ItIfxpS0u85v06jTsh6QMVBbno+lDmquW4mGFRp3+iTKwyQ8a09t8cwM2jeyYD0s4OTD861FsgZ1mt4xijD7qhTRsc8WHPP6uj+76jJ3F5zhgtM0FnSZsi90VXEVIZUP8HRl7Dgoycd5cQYMup/YpZZSgdEVmJZ9eP89FZN5KMRYHda/d3+ku0yI02jOrIx8w0EiicuOCYPf2SWaOSgh0go6HrEPQB3pfd2TY81aTfHFNMDYp/Hb0oMRy2eF5zoPUL9vwMViXUrt4l6rAuGQTg/CilklvpKrfE0U6PblDsixgVLg+YaBA1U+0uzD39sr7IDEYRKI25RpBo59k5FoxkvnEdf0rqKlLIKW35rJJiIU6Kh4mqxz5jcpHndvsr7/sQ6nnS38Aua1Xt/ePzVqftLvt+xKeHsPXFRERCISfMq3dYqy2qEGdj5muSa/6h06KJlnGwOiFcVgfw=",
        "request": "activation",
        "hardware_id": "hw000020"
    },
    {
        "customer": {
            "email": "[email protected]",
            "company_name": "",
            "reference": "00QJ6000001ipQ1MAI",
            "phone": "4554334",
            "first_name": "adfasd",
            "last_name": "fzdf",
            "city": "",
            "postcode": "",
            "state": "",
            "country": "HR",
            "address": "",
            "customer_account": null,
            "metadata": {}
        },
        "custom_fields": [],
        "product_features": [],
        "validity_period": null,
        "allow_grace_period": false,
        "grace_period": 0,
        "license_type": "perpetual",
        "license_key": "N9WG-RY5A-Q59M-2LB2",
        "is_trial": false,
        "active": false,
        "enable_maintenance_period": false,
        "maintenance_period": null,
        "max_activations": 1,
        "allow_unlimited_activations": false,
        "times_activated": 1,
        "allow_overages": false,
        "max_overages": 0,
        "prevent_vm": false,
        "is_floating_cloud": false,
        "is_floating": false,
        "floating_timeout": 120,
        "transfer_count": 0,
        "max_transfers": 0,
        "start_date": null,
        "product_details": {
            "product_id": 1586066454419515,
            "product_name": "license-62706",
            "short_code": "62706",
            "allow_trial": false,
            "trial_days": 0,
            "authorization_method": "license-key",
            "allow_overages": false,
            "max_overages": 0,
            "prevent_vm": false,
            "validity_period": null,
            "floating_timeout": 120,
            "company_id": 276,
            "metadata": {}
        },
        "can_borrow": false,
        "max_borrow_time": 0,
        "device_id": 1733403638411069,
        "id": 1733403616624039,
        "metadata": {},
        "is_hardware_key_auth": false,
        "is_air_gapped": false,
        "license_signature": "raLoZyMSIuHbhum4y9L3JgBog5RwocCXvYWLtn4gt+GGxtoxed8WA57f4J1kz5PdUdZTrSs4vT5hWDiXIwDcr4tZ7fkxyH4nS55wDea61KaYsRmlDUbesgQbn1grVSL0AgfUnnxfav9AbTM0J5/UNPbw3F1ceFl26hMKv+3N67EoMSvjntyfop10BI/azbdgxr1sMF2jkPLztPFEgmrnkSEU1Vxs6ItIfxpS0u85v06jTsh6QMVBbno+lDmquW4mGFRp3+iTKwyQ8a09t8cwM2jeyYD0s4OTD861FsgZ1mt4xijD7qhTRsc8WHPP6uj+76jJ3F5zhgtM0FnSZsi90VXEVIZUP8HRl7Dgoycd5cQYMup/YpZZSgdEVmJZ9eP89FZN5KMRYHda/d3+ku0yI02jOrIx8w0EiicuOCYPf2SWaOSgh0go6HrEPQB3pfd2TY81aTfHFNMDYp/Hb0oMRy2eF5zoPUL9vwMViXUrt4l6rAuGQTg/CilklvpKrfE0U6PblDsixgVLg+YaBA1U+0uzD39sr7IDEYRKI25RpBo59k5FoxkvnEdf0rqKlLIKW35rJJiIU6Kh4mqxz5jcpHndvsr7/sQ6nnS38Aua1Xt/ePzVqftLvt+xKeHsPXFRERCISfMq3dYqy2qEGdj5muSa/6h06KJlnGwOiFcVgfw=",
        "request": "activation",
        "hardware_id": "hw000020"
    },
    {
        "customer": {
            "email": "[email protected]",
            "company_name": "",
            "reference": "00QJ6000001ipQ1MAI",
            "phone": "4554334",
            "first_name": "adfasd",
            "last_name": "fzdf",
            "city": "",
            "postcode": "",
            "state": "",
            "country": "HR",
            "address": "",
            "customer_account": null,
            "metadata": {}
        },
        "custom_fields": [],
        "product_features": [],
        "validity_period": null,
        "allow_grace_period": false,
        "grace_period": 0,
        "license_type": "perpetual",
        "license_key": "N9WG-RY5A-Q59M-2LB2",
        "is_trial": false,
        "active": false,
        "enable_maintenance_period": false,
        "maintenance_period": null,
        "max_activations": 1,
        "allow_unlimited_activations": false,
        "times_activated": 1,
        "allow_overages": false,
        "max_overages": 0,
        "prevent_vm": false,
        "is_floating_cloud": false,
        "is_floating": false,
        "floating_timeout": 120,
        "transfer_count": 0,
        "max_transfers": 0,
        "start_date": null,
        "product_details": {
            "product_id": 1586066454419518,
            "product_name": "license-34597",
            "short_code": "34597",
            "allow_trial": true,
            "trial_days": 30,
            "authorization_method": "license-key",
            "allow_overages": false,
            "max_overages": 0,
            "prevent_vm": false,
            "validity_period": null,
            "floating_timeout": 120,
            "company_id": 276,
            "metadata": {}
        },
        "can_borrow": false,
        "max_borrow_time": 0,
        "device_id": 1733403638909079,
        "id": 1733403616712049,
        "metadata": {},
        "is_hardware_key_auth": false,
        "is_air_gapped": false,
        "license_signature": "raLoZyMSIuHbhum4y9L3JgBog5RwocCXvYWLtn4gt+GGxtoxed8WA57f4J1kz5PdUdZTrSs4vT5hWDiXIwDcr4tZ7fkxyH4nS55wDea61KaYsRmlDUbesgQbn1grVSL0AgfUnnxfav9AbTM0J5/UNPbw3F1ceFl26hMKv+3N67EoMSvjntyfop10BI/azbdgxr1sMF2jkPLztPFEgmrnkSEU1Vxs6ItIfxpS0u85v06jTsh6QMVBbno+lDmquW4mGFRp3+iTKwyQ8a09t8cwM2jeyYD0s4OTD861FsgZ1mt4xijD7qhTRsc8WHPP6uj+76jJ3F5zhgtM0FnSZsi90VXEVIZUP8HRl7Dgoycd5cQYMup/YpZZSgdEVmJZ9eP89FZN5KMRYHda/d3+ku0yI02jOrIx8w0EiicuOCYPf2SWaOSgh0go6HrEPQB3pfd2TY81aTfHFNMDYp/Hb0oMRy2eF5zoPUL9vwMViXUrt4l6rAuGQTg/CilklvpKrfE0U6PblDsixgVLg+YaBA1U+0uzD39sr7IDEYRKI25RpBo59k5FoxkvnEdf0rqKlLIKW35rJJiIU6Kh4mqxz5jcpHndvsr7/sQ6nnS38Aua1Xt/ePzVqftLvt+xKeHsPXFRERCISfMq3dYqy2qEGdj5muSa/6h06KJlnGwOiFcVgfw=",
        "request": "activation",
        "hardware_id": "hw000020"
    }
]
[
    {
        "customer": {
            "email": "1@1.com",
            "company_name": "",
            "reference": "00QJ6000001ipQ1MAI",
            "phone": "4554334",
            "first_name": "adfasd",
            "last_name": "fzdf",
            "city": "",
            "postcode": "",
            "state": "",
            "country": "HR",
            "address": "",
            "customer_account": null,
            "metadata": {}
        },
        "custom_fields": [],
        "product_features": [],
        "validity_period": null,
        "allow_grace_period": false,
        "grace_period": 0,
        "license_type": "perpetual",
        "license_key": "N9WG-RY5A-Q59M-2LB2",
        "is_trial": false,
        "active": false,
        "enable_maintenance_period": false,
        "maintenance_period": null,
        "max_activations": 1,
        "allow_unlimited_activations": false,
        "times_activated": 1,
        "allow_overages": false,
        "max_overages": 0,
        "prevent_vm": false,
        "is_floating_cloud": false,
        "is_floating": false,
        "floating_timeout": 120,
        "transfer_count": 0,
        "max_transfers": 0,
        "start_date": null,
        "product_details": {
            "product_id": 1586066454419525,
            "product_name": "test_bundle",
            "short_code": "b23",
            "allow_trial": true,
            "trial_days": 15,
            "authorization_method": "license-key",
            "allow_overages": false,
            "max_overages": 0,
            "prevent_vm": false,
            "validity_period": null,
            "floating_timeout": 120,
            "company_id": 276,
            "metadata": {}
        },
        "can_borrow": false,
        "max_borrow_time": 0,
        "device_id": 1733403637808059,
        "id": 1733403616622029,
        "metadata": {},
        "is_hardware_key_auth": false,
        "is_air_gapped": false,
        "license_signature": "raLoZyMSIuHbhum4y9L3JgBog5RwocCXvYWLtn4gt+GGxtoxed8WA57f4J1kz5PdUdZTrSs4vT5hWDiXIwDcr4tZ7fkxyH4nS55wDea61KaYsRmlDUbesgQbn1grVSL0AgfUnnxfav9AbTM0J5/UNPbw3F1ceFl26hMKv+3N67EoMSvjntyfop10BI/azbdgxr1sMF2jkPLztPFEgmrnkSEU1Vxs6ItIfxpS0u85v06jTsh6QMVBbno+lDmquW4mGFRp3+iTKwyQ8a09t8cwM2jeyYD0s4OTD861FsgZ1mt4xijD7qhTRsc8WHPP6uj+76jJ3F5zhgtM0FnSZsi90VXEVIZUP8HRl7Dgoycd5cQYMup/YpZZSgdEVmJZ9eP89FZN5KMRYHda/d3+ku0yI02jOrIx8w0EiicuOCYPf2SWaOSgh0go6HrEPQB3pfd2TY81aTfHFNMDYp/Hb0oMRy2eF5zoPUL9vwMViXUrt4l6rAuGQTg/CilklvpKrfE0U6PblDsixgVLg+YaBA1U+0uzD39sr7IDEYRKI25RpBo59k5FoxkvnEdf0rqKlLIKW35rJJiIU6Kh4mqxz5jcpHndvsr7/sQ6nnS38Aua1Xt/ePzVqftLvt+xKeHsPXFRERCISfMq3dYqy2qEGdj5muSa/6h06KJlnGwOiFcVgfw=",
        "request": "activation",
        "hardware_id": "hw000020"
    },
    {
        "customer": {
            "email": "1@1.com",
            "company_name": "",
            "reference": "00QJ6000001ipQ1MAI",
            "phone": "4554334",
            "first_name": "adfasd",
            "last_name": "fzdf",
            "city": "",
            "postcode": "",
            "state": "",
            "country": "HR",
            "address": "",
            "customer_account": null,
            "metadata": {}
        },
        "custom_fields": [],
        "product_features": [],
        "validity_period": null,
        "allow_grace_period": false,
        "grace_period": 0,
        "license_type": "perpetual",
        "license_key": "N9WG-RY5A-Q59M-2LB2",
        "is_trial": false,
        "active": false,
        "enable_maintenance_period": false,
        "maintenance_period": null,
        "max_activations": 1,
        "allow_unlimited_activations": false,
        "times_activated": 1,
        "allow_overages": false,
        "max_overages": 0,
        "prevent_vm": false,
        "is_floating_cloud": false,
        "is_floating": false,
        "floating_timeout": 120,
        "transfer_count": 0,
        "max_transfers": 0,
        "start_date": null,
        "product_details": {
            "product_id": 1586066454419515,
            "product_name": "license-62706",
            "short_code": "62706",
            "allow_trial": false,
            "trial_days": 0,
            "authorization_method": "license-key",
            "allow_overages": false,
            "max_overages": 0,
            "prevent_vm": false,
            "validity_period": null,
            "floating_timeout": 120,
            "company_id": 276,
            "metadata": {}
        },
        "can_borrow": false,
        "max_borrow_time": 0,
        "device_id": 1733403638411069,
        "id": 1733403616624039,
        "metadata": {},
        "is_hardware_key_auth": false,
        "is_air_gapped": false,
        "license_signature": "raLoZyMSIuHbhum4y9L3JgBog5RwocCXvYWLtn4gt+GGxtoxed8WA57f4J1kz5PdUdZTrSs4vT5hWDiXIwDcr4tZ7fkxyH4nS55wDea61KaYsRmlDUbesgQbn1grVSL0AgfUnnxfav9AbTM0J5/UNPbw3F1ceFl26hMKv+3N67EoMSvjntyfop10BI/azbdgxr1sMF2jkPLztPFEgmrnkSEU1Vxs6ItIfxpS0u85v06jTsh6QMVBbno+lDmquW4mGFRp3+iTKwyQ8a09t8cwM2jeyYD0s4OTD861FsgZ1mt4xijD7qhTRsc8WHPP6uj+76jJ3F5zhgtM0FnSZsi90VXEVIZUP8HRl7Dgoycd5cQYMup/YpZZSgdEVmJZ9eP89FZN5KMRYHda/d3+ku0yI02jOrIx8w0EiicuOCYPf2SWaOSgh0go6HrEPQB3pfd2TY81aTfHFNMDYp/Hb0oMRy2eF5zoPUL9vwMViXUrt4l6rAuGQTg/CilklvpKrfE0U6PblDsixgVLg+YaBA1U+0uzD39sr7IDEYRKI25RpBo59k5FoxkvnEdf0rqKlLIKW35rJJiIU6Kh4mqxz5jcpHndvsr7/sQ6nnS38Aua1Xt/ePzVqftLvt+xKeHsPXFRERCISfMq3dYqy2qEGdj5muSa/6h06KJlnGwOiFcVgfw=",
        "request": "activation",
        "hardware_id": "hw000020"
    },
    {
        "customer": {
            "email": "1@1.com",
            "company_name": "",
            "reference": "00QJ6000001ipQ1MAI",
            "phone": "4554334",
            "first_name": "adfasd",
            "last_name": "fzdf",
            "city": "",
            "postcode": "",
            "state": "",
            "country": "HR",
            "address": "",
            "customer_account": null,
            "metadata": {}
        },
        "custom_fields": [],
        "product_features": [],
        "validity_period": null,
        "allow_grace_period": false,
        "grace_period": 0,
        "license_type": "perpetual",
        "license_key": "N9WG-RY5A-Q59M-2LB2",
        "is_trial": false,
        "active": false,
        "enable_maintenance_period": false,
        "maintenance_period": null,
        "max_activations": 1,
        "allow_unlimited_activations": false,
        "times_activated": 1,
        "allow_overages": false,
        "max_overages": 0,
        "prevent_vm": false,
        "is_floating_cloud": false,
        "is_floating": false,
        "floating_timeout": 120,
        "transfer_count": 0,
        "max_transfers": 0,
        "start_date": null,
        "product_details": {
            "product_id": 1586066454419518,
            "product_name": "license-34597",
            "short_code": "34597",
            "allow_trial": true,
            "trial_days": 30,
            "authorization_method": "license-key",
            "allow_overages": false,
            "max_overages": 0,
            "prevent_vm": false,
            "validity_period": null,
            "floating_timeout": 120,
            "company_id": 276,
            "metadata": {}
        },
        "can_borrow": false,
        "max_borrow_time": 0,
        "device_id": 1733403638909079,
        "id": 1733403616712049,
        "metadata": {},
        "is_hardware_key_auth": false,
        "is_air_gapped": false,
        "license_signature": "raLoZyMSIuHbhum4y9L3JgBog5RwocCXvYWLtn4gt+GGxtoxed8WA57f4J1kz5PdUdZTrSs4vT5hWDiXIwDcr4tZ7fkxyH4nS55wDea61KaYsRmlDUbesgQbn1grVSL0AgfUnnxfav9AbTM0J5/UNPbw3F1ceFl26hMKv+3N67EoMSvjntyfop10BI/azbdgxr1sMF2jkPLztPFEgmrnkSEU1Vxs6ItIfxpS0u85v06jTsh6QMVBbno+lDmquW4mGFRp3+iTKwyQ8a09t8cwM2jeyYD0s4OTD861FsgZ1mt4xijD7qhTRsc8WHPP6uj+76jJ3F5zhgtM0FnSZsi90VXEVIZUP8HRl7Dgoycd5cQYMup/YpZZSgdEVmJZ9eP89FZN5KMRYHda/d3+ku0yI02jOrIx8w0EiicuOCYPf2SWaOSgh0go6HrEPQB3pfd2TY81aTfHFNMDYp/Hb0oMRy2eF5zoPUL9vwMViXUrt4l6rAuGQTg/CilklvpKrfE0U6PblDsixgVLg+YaBA1U+0uzD39sr7IDEYRKI25RpBo59k5FoxkvnEdf0rqKlLIKW35rJJiIU6Kh4mqxz5jcpHndvsr7/sQ6nnS38Aua1Xt/ePzVqftLvt+xKeHsPXFRERCISfMq3dYqy2qEGdj5muSa/6h06KJlnGwOiFcVgfw=",
        "request": "activation",
        "hardware_id": "hw000020"
    }
]
﻿
Schema
Request Body
TypeScript
JSON
type BundleActivationRequestBody = ({

  // for key-based licenses:
  license_key: string

} | {

  // for user-based licenses:
  username: string
  password: string

} | {

  // for user-based licenses using single sign-on Implicit grant:
  id_token: string
  customer_account_code: string

} | {

  // for user-based licenses using single sign-on Authorization code grant:
  code: string
  customer_account_code: string

}) & {

  // required properties:
  hardware_id: string
  product: string

  // optional properties:
  bundle_code?: string | undefined
  license_id?: number | undefined
  is_vm?: boolean | undefined
  vm_info?: string | undefined
  os_ver?: string | undefined
  hostname?: string | undefined
  os_hostname?: string | undefined
  ip?: string | undefined
  ip_local?: string | undefined
  app_ver?: string | undefined
  sdk_ver?: string | undefined
  mac_address?: string | undefined
  variables?: { [key: string]: string } | undefined
}
type BundleActivationRequestBody = ({

  // for key-based licenses:
  license_key: string

} | {

  // for user-based licenses:
  username: string
  password: string

} | {

  // for user-based licenses using single sign-on Implicit grant:
  id_token: string
  customer_account_code: string

} | {

  // for user-based licenses using single sign-on Authorization code grant:
  code: string
  customer_account_code: string

}) & {

  // required properties:
  hardware_id: string
  product: string

  // optional properties:
  bundle_code?: string | undefined
  license_id?: number | undefined
  is_vm?: boolean | undefined
  vm_info?: string | undefined
  os_ver?: string | undefined
  hostname?: string | undefined
  os_hostname?: string | undefined
  ip?: string | undefined
  ip_local?: string | undefined
  app_ver?: string | undefined
  sdk_ver?: string | undefined
  mac_address?: string | undefined
  variables?: { [key: string]: string } | undefined
}
﻿
Response Body
TypeScript
JSON
type BundleActivationResponseList = ({ 
  id: number,
  allow_grace_period: boolean,
  allow_overages: boolean,
  allow_unlimited_activations: boolean,
  borrowed_until: string | null,
  can_borrow: boolean,
  channel: string,
  device_id: number,
  enable_maintenance_period: boolean
  environment: string,
  eula_link: string,
  floating_timeout: number,
  grace_period: number,
  hash_md5: string,
  installation_file: string,
  is_air_gapped: boolean,
  is_borrowed: boolean,
  is_expired: boolean,
  is_floating_cloud: boolean,
  is_floating: boolean,
  is_hardware_key_auth: boolean,
  license_active: boolean,
  license_enabled: boolean,
  license_signature: string,
  license_type: string,
  maintenance_period: string | null,
  max_activations: number,
  max_borrow_time: number,
  max_license_users: number,
  max_overages: number,
  max_transfers: number,
  order_store_id: string,
  prevent_vm: boolean,
  release_date: string,
  release_notes_link: string,
  requires_version: string,
  size: string,
  start_date: string | null,
  times_activated: number,
  transfer_count: number,
  validity_period: string | null, // string is in DateISO8601UTC format
  version: string,
  
  product_features: ({
    id: number,
    code: string,
    name: string,
    expiry_date: string,
    metadata: JSON,
    feature_type: 'activation' | 'consumption',
    is_floating: boolean,
    is_floating_cloud: boolean,

    // the following properties are only present if is_floating=true or is_floating_cloud=true
    floating_users: number,
    floating_timeout: number,

    // the following properties are only present if feature_type=consumption
    max_consumption: number,
    allow_unlimited_consumptions: boolean,
    total_consumptions: number,
    allow_overages: number,
    max_overages: number,
    reset_consumption: boolean,
    consumption_period: 'daily' | 'weekly' | 'monthly' | 'annualy' | null,
  })[],
  
  custom_fields: ({
    name: string,
    data_type: 'numer' | 'text' | 'date/time',
    value: string,
  })[],
  
  customer: {
    email: string,
    company_name: string,
    reference: string,
    phone: string,
    first_name: string,
    last_name: string,
    city: string,
    postcode: string,
    state: string,
    country: string,
    address: string,
    customer_account: string | null,
    metadata: JSON,
  },
  
  product_details: {
    product_id: number,
    product_name: string,
    short_code: string,
    authorization_method: 'license-key' | 'user',
    metadata: JSON,
  },
  
  metadata: JSON,
  
  // the following property is only present if is_trial=true
  trial_days: number,
  
  // the following properties is only present if is_floating=true or is_floating_cloud=true
  floating_in_use_devices: number,
  floating_users: number,
  
  // the following properties are only present if license_type='consumption'
  max_consumptions: number,
  total_consumptions: number,
  allow_unlimited_consumptions: boolean,
  reset_consumption: boolean,
  consumption_period: string | null, // string is in DateISO8601UTC format
  
} & ({

  // for key-based licenses:
  license_key: string,

} | {

  // for user-based licenses:
  user: {
    id: number,
    email: string,
    first_name: string,
    last_name: string,
    phone_number: string,
    is_initial_password: boolean,
    max_activations: number,
    allow_unlimited_activations: boolean,
    total_activations: number
  }

})[];
type BundleActivationResponseList = ({ 
  id: number,
  allow_grace_period: boolean,
  allow_overages: boolean,
  allow_unlimited_activations: boolean,
  borrowed_until: string | null,
  can_borrow: boolean,
  channel: string,
  device_id: number,
  enable_maintenance_period: boolean
  environment: string,
  eula_link: string,
  floating_timeout: number,
  grace_period: number,
  hash_md5: string,
  installation_file: string,
  is_air_gapped: boolean,
  is_borrowed: boolean,
  is_expired: boolean,
  is_floating_cloud: boolean,
  is_floating: boolean,
  is_hardware_key_auth: boolean,
  license_active: boolean,
  license_enabled: boolean,
  license_signature: string,
  license_type: string,
  maintenance_period: string | null,
  max_activations: number,
  max_borrow_time: number,
  max_license_users: number,
  max_overages: number,
  max_transfers: number,
  order_store_id: string,
  prevent_vm: boolean,
  release_date: string,
  release_notes_link: string,
  requires_version: string,
  size: string,
  start_date: string | null,
  times_activated: number,
  transfer_count: number,
  validity_period: string | null, // string is in DateISO8601UTC format
  version: string,
  
  product_features: ({
    id: number,
    code: string,
    name: string,
    expiry_date: string,
    metadata: JSON,
    feature_type: 'activation' | 'consumption',
    is_floating: boolean,
    is_floating_cloud: boolean,

    // the following properties are only present if is_floating=true or is_floating_cloud=true
    floating_users: number,
    floating_timeout: number,

    // the following properties are only present if feature_type=consumption
    max_consumption: number,
    allow_unlimited_consumptions: boolean,
    total_consumptions: number,
    allow_overages: number,
    max_overages: number,
    reset_consumption: boolean,
    consumption_period: 'daily' | 'weekly' | 'monthly' | 'annualy' | null,
  })[],
  
  custom_fields: ({
    name: string,
    data_type: 'numer' | 'text' | 'date/time',
    value: string,
  })[],
  
  customer: {
    email: string,
    company_name: string,
    reference: string,
    phone: string,
    first_name: string,
    last_name: string,
    city: string,
    postcode: string,
    state: string,
    country: string,
    address: string,
    customer_account: string | null,
    metadata: JSON,
  },
  
  product_details: {
    product_id: number,
    product_name: string,
    short_code: string,
    authorization_method: 'license-key' | 'user',
    metadata: JSON,
  },
  
  metadata: JSON,
  
  // the following property is only present if is_trial=true
  trial_days: number,
  
  // the following properties is only present if is_floating=true or is_floating_cloud=true
  floating_in_use_devices: number,
  floating_users: number,
  
  // the following properties are only present if license_type='consumption'
  max_consumptions: number,
  total_consumptions: number,
  allow_unlimited_consumptions: boolean,
  reset_consumption: boolean,
  consumption_period: string | null, // string is in DateISO8601UTC format
  
} & ({

  // for key-based licenses:
  license_key: string,

} | {

  // for user-based licenses:
  user: {
    id: number,
    email: string,
    first_name: string,
    last_name: string,
    phone_number: string,
    is_initial_password: boolean,
    max_activations: number,
    allow_unlimited_activations: boolean,
    total_activations: number
  }

})[];
﻿
License Authorization Method
There are two types of product licenses based on how the client application authorizes itself to interact with a license:
Key-based product licenses
Each license assigned to the product requires the client to provide a license key in order to activate, check or deactivate the license (property license_key in the request body).
The license response object will contain the license_key property, and the property product_details.authorization_method will be the string license_key.
User-based product licenses
Each license assigned to the product has a corresponding "license user" instead of a license key. There are multiple ways a user-based product license can be accessed when making a request:
By providing the values for username and password for the license user
By providing the values for id_token and customer_account_code if using single sign-on authentication using Implicit grant
By providing the values for code and customer_account_code if using single sign-on authentication using Authorization code grant
﻿
In the license response object, product_details.authorization_method will have the string value user and the response object will contain the user object with information on the license user. 
License Types
The license_type property defines one of the 4 types of licenses based on their duration and how the license is used:
Perpetual: perpetual
Time-limited: time-limited
Subscription: subscription
Consumption: consumption
For more information see: License Types﻿ 
Errors
If an error occurs, the response will have an HTTP status code of 400 or higher, and the response body will contain an error description in the following format:
TypeScript
{
  status: number,
  code: string,
  message: string
}
{
  status: number,
  code: string,
  message: string
}
﻿
List of Exceptions
unknown_product (400): Provided product was not found
product_not_bundle (400): Specified product "code" is not a bundle
license_not_found (400): License with the provided license user not found
license_not_enabled (400): The license is not enabled
vm_not_allowed (400): Virtual machine not allowed
offline_floating_cloud_not_supported (400): Floating cloud licenses cannot be activated offline
license_start_date_error (400): This license cannot be activated before start date: {date}
blacklisted (400): This device is blacklisted
license_activated_max_times (400): This license key has already been activated the maximum number of times
license_user_activated_max_times (400): License user has activated this license max times
license_expired (400): License validity period has expired
license_transferred_max_times (400): This license has already been transferred the maximum number of times
license_device_exists (409): A device matching this hardware_id is already created on the license.
﻿
Updated 17 Jan 2025
Did this page help you?
Deactivate License (Offline Method)
License Check