Activate Bundle (Online Method)

{ "tab" "examples", "url" "/api/v4/activate bundle", "name" "/api/v4/activate bundle", "method" "post", "request" { "pathparameters" \[], "queryparameters" \[], "headerparameters" \[ { "kind" "required", "name" "date", "type" "string", "children" \[], "description" "in rfc7231 format (see \\"license api authorization\\"), eg thu, 17 nov 2022 20 51 35 gmt" }, { "kind" "required", "name" "authorization", "type" "string", "children" \[], "description" "see \\"license api authorization\\" article" } ], "bodydataparameters" \[ { "kind" "required", "name" "hardware id", "type" "string", "children" \[], "description" "unique hardware id generated for the client device" }, { "kind" "required", "name" "product", "type" "string", "children" \[], "description" "product bundle short code" }, { "kind" "optional", "name" "license key", "type" "string", "children" \[], "description" "required if product is key based (see section below)" }, { "kind" "optional", "name" "username", "type" "string", "children" \[], "description" "required if product is user based (see section below)" }, { "kind" "optional", "name" "password", "type" "string", "children" \[], "description" "required if product is user based (see section below)" }, { "kind" "optional", "name" "id token", "type" "string", "children" \[], "description" "required if using sso (see section below) this is the id token received from the sso if implicit grant authorization method is being used " }, { "kind" "optional", "name" "code", "type" "string", "children" \[], "description" "required if using sso (see section below) this is the code received from the sso if authorization code grant method is being used " }, { "kind" "optional", "name" "customer account code", "type" "string", "children" \[], "description" "required if using sso (see section below) this is the customer account code to which sso provider is configured " }, { "name" "redirect uri", "kind" "optional", "type" "string", "description" "required if using sso with a non default redirect uri (see below)", "" "required if using sso with a non default redirect uri (see below)" }, { "name" "license id", "kind" "optional", "type" "string", "description" "ensures that the action affects only the license with the specified id this is useful if e g you have multiple licenses for the same product assigned to the same user for obtaining a list of licenses assigned to a user, see \\"user licenses\\"", "children" \[] }, { "name" "is vm", "kind" "optional", "type" "boolean", "description" "set to true if request is sent from a virtual machine if this value is true and prevent vm is set on the license, an error will be returned if this value is set (true or false), it will be stored in license device data", "children" \[] }, { "kind" "optional", "name" "vm info", "type" "string", "children" \[], "description" "a string describing the virtual machine environment which will be stored in license device data" }, { "kind" "optional", "name" "os ver", "type" "string", "children" \[], "description" "operating system description string which will be stored in license device data" }, { "kind" "optional", "name" "hostname", "type" "string", "children" \[], "description" "hostname string which will be stored in license device data" }, { "kind" "optional", "name" "os hostname", "type" "string", "children" \[], "description" "legacy version of \\"hostname\\" parameter (see above)" }, { "kind" "optional", "name" "ip", "type" "string", "children" \[], "description" "client ip address string which will be stored in license device data" }, { "kind" "optional", "name" "ip local", "type" "string", "children" \[], "description" "legacy version of \\"ip\\" parameter (see above)" }, { "kind" "optional", "name" "app ver", "type" "string", "children" \[], "description" "application version string which will be stored in license device data" }, { "kind" "optional", "name" "sdk ver", "type" "string", "children" \[], "description" "sdk version string which will be stored in license device data" }, { "kind" "optional", "name" "mac address", "type" "string", "children" \[], "description" "client mac address which will be stored in license device data" }, { "name" "variables", "kind" "optional", "type" "object", "description" "stores 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", "children" \[] } ], "formdataparameters" \[] }, "results" { "languages" \[ { "id" "es8g1cukjmbnpiivt9vof", "code" "\[\n {\n \\"customer\\" {\n \\"email\\" \\"1\@1 com\\",\n \\"company name\\" \\"\\",\n \\"reference\\" \\"00qj6000001ipq1mai\\",\n \\"phone\\" \\"4554334\\",\n \\"first name\\" \\"adfasd\\",\n \\"last name\\" \\"fzdf\\",\n \\"city\\" \\"\\",\n \\"postcode\\" \\"\\",\n \\"state\\" \\"\\",\n \\"country\\" \\"hr\\",\n \\"address\\" \\"\\",\n \\"customer account\\" null,\n \\"metadata\\" {}\n },\n \\"custom fields\\" \[],\n \\"product features\\" \[],\n \\"validity period\\" null,\n \\"allow grace period\\" false,\n \\"grace period\\" 0,\n \\"license type\\" \\"perpetual\\",\n \\"license key\\" \\"n9wg ry5a q59m 2lb2\\",\n \\"is trial\\" false,\n \\"active\\" false,\n \\"enable maintenance period\\" false,\n \\"maintenance period\\" null,\n \\"max activations\\" 1,\n \\"allow unlimited activations\\" false,\n \\"times activated\\" 1,\n \\"allow overages\\" false,\n \\"max overages\\" 0,\n \\"prevent vm\\" false,\n \\"is floating cloud\\" false,\n \\"is floating\\" false,\n \\"floating timeout\\" 120,\n \\"transfer count\\" 0,\n \\"max transfers\\" 0,\n \\"start date\\" null,\n \\"product details\\" {\n \\"product id\\" 1586066454419525,\n \\"product name\\" \\"test bundle\\",\n \\"short code\\" \\"b23\\",\n \\"allow trial\\" true,\n \\"trial days\\" 15,\n \\"authorization method\\" \\"license key\\",\n \\"allow overages\\" false,\n \\"max overages\\" 0,\n \\"prevent vm\\" false,\n \\"validity period\\" null,\n \\"floating timeout\\" 120,\n \\"company id\\" 276,\n \\"metadata\\" {}\n },\n \\"can borrow\\" false,\n \\"max borrow time\\" 0,\n \\"device id\\" 1733403637808059,\n \\"id\\" 1733403616622029,\n \\"metadata\\" {},\n \\"is hardware key auth\\" false,\n \\"is air gapped\\" false,\n \\"license signature\\" \\"ralozymsiuhbhum4y9l3jgbog5rwoccxvywltn4gt+ggxtoxed8wa57f4j1kz5pdudztrss4vt5hwdixiwdcr4tz7fkxyh4ns55wdea61kaysrmldubesgqbn1grvsl0agfunnxfav9abtm0j5/unpbw3f1cefl26hmkv+3n67eomsvjntyfop10bi/azbdgxr1smf2jkplztpfegmrnkseu1vxs6itifxps0u85v06jtsh6qmvbbno+ldmquw4mgfrp3+itkwyq8a09t8cwm2jeyyd0s4otd861fsgz1mt4xijd7qhtrsc8whpp6uj+76jj3f5zhgtm0fnszsi90vxevizup8hrl7dgoycd5cqymup/ypzzsgdevmjz9ep89fzn5kmryhda/d3+ku0yi02jorix8w0eiicuocypf2swaosgh0go6hrepqb3pfd2ty81atfhfnmdyp/hb0omry2ef5zopul9vwmvixurt4l6raugqtg/cilklvpkrfe0u6pbldsixgvlg+yaba1u+0uzd39sr7ideyrki25rpbo59k5foxkvnedf0rqkllikw35rjjiiu6kh4mqxz5jcphndvsr7/sq6nns38aua1xt/epzvqftlvt+xkehspxfrercisfmq3dyqy2qegdj5musa/6h06kjlngwoifcvgfw=\\",\n \\"request\\" \\"activation\\",\n \\"hardware id\\" \\"hw000020\\"\n },\n {\n \\"customer\\" {\n \\"email\\" \\"1\@1 com\\",\n \\"company name\\" \\"\\",\n \\"reference\\" \\"00qj6000001ipq1mai\\",\n \\"phone\\" \\"4554334\\",\n \\"first name\\" \\"adfasd\\",\n \\"last name\\" \\"fzdf\\",\n \\"city\\" \\"\\",\n \\"postcode\\" \\"\\",\n \\"state\\" \\"\\",\n \\"country\\" \\"hr\\",\n \\"address\\" \\"\\",\n \\"customer account\\" null,\n \\"metadata\\" {}\n },\n \\"custom fields\\" \[],\n \\"product features\\" \[],\n \\"validity period\\" null,\n \\"allow grace period\\" false,\n \\"grace period\\" 0,\n \\"license type\\" \\"perpetual\\",\n \\"license key\\" \\"n9wg ry5a q59m 2lb2\\",\n \\"is trial\\" false,\n \\"active\\" false,\n \\"enable maintenance period\\" false,\n \\"maintenance period\\" null,\n \\"max activations\\" 1,\n \\"allow unlimited activations\\" false,\n \\"times activated\\" 1,\n \\"allow overages\\" false,\n \\"max overages\\" 0,\n \\"prevent vm\\" false,\n \\"is floating cloud\\" false,\n \\"is floating\\" false,\n \\"floating timeout\\" 120,\n \\"transfer count\\" 0,\n \\"max transfers\\" 0,\n \\"start date\\" null,\n \\"product details\\" {\n \\"product id\\" 1586066454419515,\n \\"product name\\" \\"license 62706\\",\n \\"short code\\" \\"62706\\",\n \\"allow trial\\" false,\n \\"trial days\\" 0,\n \\"authorization method\\" \\"license key\\",\n \\"allow overages\\" false,\n \\"max overages\\" 0,\n \\"prevent vm\\" false,\n \\"validity period\\" null,\n \\"floating timeout\\" 120,\n \\"company id\\" 276,\n \\"metadata\\" {}\n },\n \\"can borrow\\" false,\n \\"max borrow time\\" 0,\n \\"device id\\" 1733403638411069,\n \\"id\\" 1733403616624039,\n \\"metadata\\" {},\n \\"is hardware key auth\\" false,\n \\"is air gapped\\" false,\n \\"license signature\\" \\"ralozymsiuhbhum4y9l3jgbog5rwoccxvywltn4gt+ggxtoxed8wa57f4j1kz5pdudztrss4vt5hwdixiwdcr4tz7fkxyh4ns55wdea61kaysrmldubesgqbn1grvsl0agfunnxfav9abtm0j5/unpbw3f1cefl26hmkv+3n67eomsvjntyfop10bi/azbdgxr1smf2jkplztpfegmrnkseu1vxs6itifxps0u85v06jtsh6qmvbbno+ldmquw4mgfrp3+itkwyq8a09t8cwm2jeyyd0s4otd861fsgz1mt4xijd7qhtrsc8whpp6uj+76jj3f5zhgtm0fnszsi90vxevizup8hrl7dgoycd5cqymup/ypzzsgdevmjz9ep89fzn5kmryhda/d3+ku0yi02jorix8w0eiicuocypf2swaosgh0go6hrepqb3pfd2ty81atfhfnmdyp/hb0omry2ef5zopul9vwmvixurt4l6raugqtg/cilklvpkrfe0u6pbldsixgvlg+yaba1u+0uzd39sr7ideyrki25rpbo59k5foxkvnedf0rqkllikw35rjjiiu6kh4mqxz5jcphndvsr7/sq6nns38aua1xt/epzvqftlvt+xkehspxfrercisfmq3dyqy2qegdj5musa/6h06kjlngwoifcvgfw=\\",\n \\"request\\" \\"activation\\",\n \\"hardware id\\" \\"hw000020\\"\n },\n {\n \\"customer\\" {\n \\"email\\" \\"1\@1 com\\",\n \\"company name\\" \\"\\",\n \\"reference\\" \\"00qj6000001ipq1mai\\",\n \\"phone\\" \\"4554334\\",\n \\"first name\\" \\"adfasd\\",\n \\"last name\\" \\"fzdf\\",\n \\"city\\" \\"\\",\n \\"postcode\\" \\"\\",\n \\"state\\" \\"\\",\n \\"country\\" \\"hr\\",\n \\"address\\" \\"\\",\n \\"customer account\\" null,\n \\"metadata\\" {}\n },\n \\"custom fields\\" \[],\n \\"product features\\" \[],\n \\"validity period\\" null,\n \\"allow grace period\\" false,\n \\"grace period\\" 0,\n \\"license type\\" \\"perpetual\\",\n \\"license key\\" \\"n9wg ry5a q59m 2lb2\\",\n \\"is trial\\" false,\n \\"active\\" false,\n \\"enable maintenance period\\" false,\n \\"maintenance period\\" null,\n \\"max activations\\" 1,\n \\"allow unlimited activations\\" false,\n \\"times activated\\" 1,\n \\"allow overages\\" false,\n \\"max overages\\" 0,\n \\"prevent vm\\" false,\n \\"is floating cloud\\" false,\n \\"is floating\\" false,\n \\"floating timeout\\" 120,\n \\"transfer count\\" 0,\n \\"max transfers\\" 0,\n \\"start date\\" null,\n \\"product details\\" {\n \\"product id\\" 1586066454419518,\n \\"product name\\" \\"license 34597\\",\n \\"short code\\" \\"34597\\",\n \\"allow trial\\" true,\n \\"trial days\\" 30,\n \\"authorization method\\" \\"license key\\",\n \\"allow overages\\" false,\n \\"max overages\\" 0,\n \\"prevent vm\\" false,\n \\"validity period\\" null,\n \\"floating timeout\\" 120,\n \\"company id\\" 276,\n \\"metadata\\" {}\n },\n \\"can borrow\\" false,\n \\"max borrow time\\" 0,\n \\"device id\\" 1733403638909079,\n \\"id\\" 1733403616712049,\n \\"metadata\\" {},\n \\"is hardware key auth\\" false,\n \\"is air gapped\\" false,\n \\"license signature\\" \\"ralozymsiuhbhum4y9l3jgbog5rwoccxvywltn4gt+ggxtoxed8wa57f4j1kz5pdudztrss4vt5hwdixiwdcr4tz7fkxyh4ns55wdea61kaysrmldubesgqbn1grvsl0agfunnxfav9abtm0j5/unpbw3f1cefl26hmkv+3n67eomsvjntyfop10bi/azbdgxr1smf2jkplztpfegmrnkseu1vxs6itifxps0u85v06jtsh6qmvbbno+ldmquw4mgfrp3+itkwyq8a09t8cwm2jeyyd0s4otd861fsgz1mt4xijd7qhtrsc8whpp6uj+76jj3f5zhgtm0fnszsi90vxevizup8hrl7dgoycd5cqymup/ypzzsgdevmjz9ep89fzn5kmryhda/d3+ku0yi02jorix8w0eiicuocypf2swaosgh0go6hrepqb3pfd2ty81atfhfnmdyp/hb0omry2ef5zopul9vwmvixurt4l6raugqtg/cilklvpkrfe0u6pbldsixgvlg+yaba1u+0uzd39sr7ideyrki25rpbo59k5foxkvnedf0rqkllikw35rjjiiu6kh4mqxz5jcphndvsr7/sq6nns38aua1xt/epzvqftlvt+xkehspxfrercisfmq3dyqy2qegdj5musa/6h06kjlngwoifcvgfw=\\",\n \\"request\\" \\"activation\\",\n \\"hardware id\\" \\"hw000020\\"\n }\n]", "language" "200", "customlabel" "" }, { "id" "7eyilksv2qgjcowesdz 2", "code" "{\n \\"unknown product\\" \\"provided product was not found\\",\n \\"product not bundle\\" \\"specified product \\\\\\"productcode\\\\\\" is not a bundle\\",\n \\"license not found\\" \\"license with the provided license user not found\\",\n \\"license not enabled\\" \\"the license is not enabled\\",\n \\"vm not allowed\\" \\"virtual machine not allowed\\",\n \\"offline floating cloud not supported\\" \\" floating cloud licenses cannot be activated offline \\",\n \\"license start date error\\" \\"this license cannot be activated before start date {date}\\",\n \\"blacklisted\\" \\"this device is blacklisted\\",\n \\"license activated max times\\" \\"this license has already been activated the maximum number of times\\",\n \\"license user activated max times\\" \\"license user has activated this license max times\\",\n \\"license expired\\" \\"license validity period has expired \\",\n \\"license transferred max times\\" \\"this license has already been transferred the maximum number of times\\",\n \\"license device exists\\" \\"a device matching this hardware id is already created on the license\\"\n}", "language" "400", "customlabel" "" } ], "selectedlanguageid" "es8g1cukjmbnpiivt9vof" }, "examples" { "languages" \[ { "id" "czwu6thnrqg1gupniepni", "code" "curl location request post '/api/v4/activate bundle' \\\\\n header 'accept application/json' \\\\\n header 'date string' \\\\\n header 'authorization string' \\\\\n data raw '{\\"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\\"}'", "language" "curl", "customlabel" "" }, { "id" "iijlvatpmzxsoo e7jymj", "code" "var request = require('request');\nvar options = {\n 'method' 'post',\n 'url' '/api/v4/activate bundle',\n 'headers' {\n 'accept' 'application/json',\n 'date' 'string',\n 'authorization' 'string'\n },\n body '{\\"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\\"}'\n\n};\nrequest(options, function (error, response) {\n if (error) throw new error(error);\n console log(response body);\n});\n", "language" "nodejs", "customlabel" "" }, { "id" "xvxt1tuwoev1j0hw305jg", "code" "var myheaders = new headers();\nmyheaders append(\\"accept\\", \\"application/json\\");\nmyheaders append(\\"date\\", \\"string\\");\nmyheaders append(\\"authorization\\", \\"string\\");\n\nvar raw = \\"{\\\\\\"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\\\\\\"}\\";\n\nvar requestoptions = {\n method 'post',\n headers myheaders,\n body raw,\n redirect 'follow'\n};\n\nfetch(\\"/api/v4/activate bundle\\", requestoptions)\n then(response => response text())\n then(result => console log(result))\n catch(error => console log('error', error));", "language" "javascript", "customlabel" "" }, { "id" "q 2i3blnzmcc8j0i7r7gv", "code" "import requests\n\nurl = \\"/api/v4/activate bundle\\"\n\npayload = \\"{\\\\\\"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\\\\\\"}\\"\nheaders = {\n 'accept' 'application/json',\n 'date' 'string',\n 'authorization' 'string'\n}\n\nresponse = requests request(\\"post\\", url, headers=headers, data=payload)\n\nprint(response text)\n", "language" "python", "customlabel" "" }, { "id" "08xaen4jacqj jrn1oqd", "code" "require \\"uri\\"\nrequire \\"net/http\"\n\nurl = uri(\\"/api/v4/activate bundle\\")\n\nhttp = net http new(url host, url port);\nrequest = net http post new(url)\nrequest\[\\"accept\\"] = \\"application/json\\"\nrequest\[\\"date\\"] = \\"string\\"\nrequest\[\\"authorization\\"] = \\"string\\"\nrequest body = \\"{\\\\\\"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\\\\\\"}\\"\n\nresponse = http request(request)\nputs response read body\n", "language" "ruby", "customlabel" "" } ], "selectedlanguageid" "czwu6thnrqg1gupniepni" }, "description" "activates all licenses inside of a bundle returns the list of activated licenses in response\n", "currentnewparameter" { "label" "body parameter", "value" "bodydataparameters" }, "hastryitout" false, "autogeneratedanchorslug" "apiv4activatebundle", "legacyhash" "knonhd9bivtjtszq j6 j" } schema request body 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 } json schema { "$schema" "https //json schema org/draft/2020 12/schema", "type" "object", "allof" \[ { "oneof" \[ { "type" "object", "properties" { "license key" { "type" "string" } }, "required" \["license key"], "additionalproperties" false }, { "type" "object", "properties" { "username" { "type" "string" }, "password" { "type" "string" } }, "required" \["username", "password"], "additionalproperties" false }, { "type" "object", "properties" { "id token" { "type" "string" }, "customer account code" { "type" "string" } }, "required" \["id token", "customer account code"], "additionalproperties" false }, { "type" "object", "properties" { "code" { "type" "string" }, "customer account code" { "type" "string" } }, "required" \["code", "customer account code"], "additionalproperties" false } ] }, { "type" "object", "properties" { "hardware id" { "type" "string" }, "product" { "type" "string" }, "bundle code" { "type" "string" }, "license id" { "type" "number" }, "is vm" { "type" "boolean" }, "vm info" { "type" "string" }, "os ver" { "type" "string" }, "hostname" { "type" "string" }, "os hostname" { "type" "string" }, "ip" { "type" "string" }, "ip local" { "type" "string" }, "app ver" { "type" "string" }, "sdk ver" { "type" "string" }, "mac address" { "type" "string" }, "variables" { "type" \["object", "null"], "additionalproperties" { "type" "string" } } }, "required" \["hardware id", "product"], "additionalproperties" false } ] } response body type bundleactivationresponselist = ({ id number, allow grace period boolean, allow overages boolean, allow unlimited activations boolean, borrowed until string | null, can borrow boolean, device id number, enable maintenance period boolean floating timeout number, grace period number, 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, start date string | null, times activated number, transfer count number, validity period string | null, // string is in dateiso8601utc format company { id number }, installation file id number | null, installation file null | { id number, channel string, environment string, eula link string, hash md5 string, installation file string, release date string | null, release notes link string, requires version string | null, size string | null, 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, can borrow boolean, max borrow time number })\[], 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 } })\[]; json schema { "$schema" "https //json schema org/draft/2020 12/schema", "type" "array", "items" { "type" "object", "allof" \[ { "oneof" \[ { "type" "object", "properties" { "license key" { "type" "string" } }, "required" \["license key"], "additionalproperties" false }, { "type" "object", "properties" { "user" { "type" "object", "properties" { "id" { "type" "number" }, "email" { "type" "string" }, "first name" { "type" "string" }, "last name" { "type" "string" }, "phone number" { "type" "string" }, "is initial password" { "type" "boolean" }, "max activations" { "type" "number" }, "allow unlimited activations" { "type" "boolean" }, "total activations" { "type" "number" } }, "required" \["id", "email", "first name", "last name", "phone number", "is initial password", "max activations", "allow unlimited activations", "total activations"], "additionalproperties" false } }, "required" \["user"], "additionalproperties" false } ] }, { "type" "object", "properties" { "id" { "type" "number" }, "allow grace period" { "type" "boolean" }, "allow overages" { "type" "boolean" }, "allow unlimited activations" { "type" "boolean" }, "borrowed until" { "type" \["string", "null"] }, "can borrow" { "type" "boolean" }, "device id" { "type" "number" }, "enable maintenance period" { "type" "boolean" }, "floating timeout" { "type" "number" }, "grace period" { "type" "number" }, "is air gapped" { "type" "boolean" }, "is borrowed" { "type" "boolean" }, "is expired" { "type" "boolean" }, "is floating cloud" { "type" "boolean" }, "is floating" { "type" "boolean" }, "is hardware key auth" { "type" "boolean" }, "license active" { "type" "boolean" }, "license enabled" { "type" "boolean" }, "license signature" { "type" "string" }, "license type" { "type" "string" }, "maintenance period" { "type" \["string", "null"] }, "max activations" { "type" "number" }, "max borrow time" { "type" "number" }, "max license users" { "type" "number" }, "max overages" { "type" "number" }, "max transfers" { "type" "number" }, "order store id" { "type" "string" }, "prevent vm" { "type" "boolean" }, "start date" { "type" \["string", "null"] }, "times activated" { "type" "number" }, "transfer count" { "type" "number" }, "validity period" { "type" \["string", "null"] }, "installation file id" { "type" \["number","null"] }, "installation file" { "type" "object", "properties" { "version" { "type" \["string", "null"] }, "environment" { "type" "string" }, "hash md5" { "type" \["string", "null"] }, "eula link" { "type" \["string", "null"] }, "release notes link" { "type" \["string", "null"] }, "size" { "type" \["string", "null"] }, "requires version" { "type" \["string", "null"] }, "channel" { "type" \["string", "null"] }, "installation file" { "type" \["string", "null"] }, "release date" { "type" \["string", "null"] } } }, "company" { "type" "object", "properties" {"id" { "type" "number" } } }, "product features" { "type" "array", "items" { "type" "object", "properties" { "id" { "type" "number" }, "code" { "type" "string" }, "name" { "type" "string" }, "expiry date" { "type" "string" }, "metadata" {}, "feature type" { "type" "string", "enum" \["activation", "consumption"] }, "is floating" { "type" "boolean" }, "is floating cloud" { "type" "boolean" }, "floating users" { "type" "number" }, "floating timeout" { "type" "number" }, "max consumption" { "type" "number" }, "allow unlimited consumptions" { "type" "boolean" }, "total consumptions" { "type" "number" }, "allow overages" { "type" "number" }, "max overages" { "type" "number" }, "reset consumption" { "type" "boolean" }, "max borrow time" { "type" "number" }, "can borrow" { "type" "boolean" }, "consumption period" { "type" \["string", "null"], "enum" \["daily", "weekly", "monthly", "annualy", null] } }, "required" \["id", "code", "name", "expiry date", "metadata", "feature type", "is floating", "is floating cloud"] } }, "custom fields" { "type" "array", "items" { "type" "object", "properties" { "name" { "type" "string" }, "data type" { "type" "string", "enum" \["numer", "text", "date/time"] }, "value" { "type" "string" } }, "required" \["name", "data type", "value"] } }, "customer" { "type" "object", "properties" { "email" { "type" "string" }, "company name" { "type" "string" }, "reference" { "type" "string" }, "phone" { "type" "string" }, "first name" { "type" "string" }, "last name" { "type" "string" }, "city" { "type" "string" }, "postcode" { "type" "string" }, "state" { "type" "string" }, "country" { "type" "string" }, "address" { "type" "string" }, "customer account" { "type" \["string", "null"] }, "metadata" {} }, "required" \["email", "company name", "reference", "phone", "first name", "last name", "city", "postcode", "state", "country", "address", "metadata"] }, "product details" { "type" "object", "properties" { "product id" { "type" "number" }, "product name" { "type" "string" }, "short code" { "type" "string" }, "authorization method" { "type" "string", "enum" \["license key", "user"] }, "metadata" {} }, "required" \["product id", "product name", "short code", "authorization method", "metadata"] }, "metadata" {}, "trial days" { "type" "number" }, "floating in use devices" { "type" "number" }, "floating users" { "type" "number" }, "max consumptions" { "type" "number" }, "total consumptions" { "type" "number" }, "allow unlimited consumptions" { "type" "boolean" }, "reset consumption" { "type" "boolean" }, "consumption period" { "type" \["string", "null"] } }, "required" \[ "id", "allow grace period", "allow overages", "allow unlimited activations", "can borrow", "channel", "device id", "enable maintenance period", "environment", "eula link", "floating timeout", "grace period", "hash md5", "installation file", "is air gapped", "is borrowed", "is expired", "is floating cloud", "is floating", "is hardware key auth", "license active", "license enabled", "license signature", "license type", "max activations", "max borrow time", "max license users", "max overages", "max transfers", "order store id", "prevent vm", "release date", "release notes link", "requires version", "size", "times activated", "transfer count", "version", "product features", "custom fields", "customer", "product details", "metadata" ], "additionalproperties" false } ] } } 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 docid\ xhxttcvj7gs6qeaqu7cua single sign on license activation short instructions and link to detailed section about using single sign on directly via license api can be find docid\ qbjwnphsdcs0l25uw6ptq curl location request post 'https //api licensespring com/api/v4/activate bundle/' \\ \ header 'date mon, 10 may 2021 13 14 18 gmt' \\ \ header 'authorization algorithm="hmac sha256",headers="date",signature="{generated signature}",apikey="{your api key}"' \\ \ header 'content type application/json' \\ \ data raw '{ "id token" "{id token here}", "code" "{code here}", "customer account code" "acme inc", "hardware id" "some unique id", "product" "xy" }' use either id token or code, not both at the same time if you're using sso with multiple redirect uri values enabled, you have to provide the redirect uri in this request payload if it's the non default uri (i e not the first one in the uri list) 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 { status number, code string, message string } json schema { "$schema" "https //json schema org/draft/2020 12/schema", "type" "object", "properties" { "status" { "type" "number" }, "code" { "type" "string" }, "message" { "type" "string" } }, "required" \[ "status", "code", "message" ], "additionalproperties" false } 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