License API
List Licenses
Licenses for Device
5 min
name list user licenses method get url api v4 device licenses description returns a list of licenses assigned to a device tab examples examples languages id njooa8sw1kofn5ipwkm0f language javascript code const headers new headers ; nheaders append accept application json ; nheaders append date date string ; nheaders append authorization authorization string ; n nconst requestoptions n method get n headers headers n redirect follow n ; n nconst queryparams new urlsearchparams n product product string n username username string n password password string n n tostring ; n nfetch api v4 user licenses? queryparams requestoptions n then response response text n then result console log result n catch error console log error error ; customlabel id wsr6xyqvbnw2phl9kw0c7 language curl code curl location request get api v4 device licenses?hardware id string n header accept application json n header date date string n header authorization authorization string n customlabel selectedlanguageid wsr6xyqvbnw2phl9kw0c7 results languages id 1jlwp1hw3a0 jxhz6u2 d language 200 customlabel code n n id 1702983098133459 n order store id trial 1702983098133439 n license active true n license enabled true n license type subscription n license key h62k c35n bs2j vz13 n is trial true n max license users 1 n validity period 2023 12 20 n enable maintenance period false n maintenance period null n allow grace period false n grace period 0 n max activations 1 n allow unlimited activations true n times activated 1 n start date null n transfer count 1 n max transfers 0 n allow overages false n max overages 0 n is floating cloud true n is floating false n floating timeout 120 n can borrow false n max borrow time 0 n prevent vm false n custom fields n product features n n id 1702983421931584 n code e n name e n feature type activation n expiry date null n metadata n is floating false n is floating cloud false n n n customer n email trial request n company name null n reference n phone n first name null n last name null n city n postcode n state n country n address n customer account null n metadata n n product details n product id 1584723961091040 n product name product1 n short code 1337 n authorization method license key n metadata n n metadata n is hardware key auth false n is air gapped false n floating users 1 n trial days 1 n n n id 1700060342999659 n order store id trial 1700060342999639 n license active false n license enabled true n license type subscription n license key h57y ps8l vx6j wu13 n is trial true n max license users 1 n validity period null n enable maintenance period false n maintenance period null n allow grace period false n grace period 0 n max activations 1 n allow unlimited activations false n times activated 0 n start date null n transfer count 0 n max transfers 0 n allow overages false n max overages 0 n is floating cloud true n is floating false n floating timeout 120 n can borrow false n max borrow time 0 n prevent vm false n custom fields n product features n n id 1700060342999669 n code ccc n name ccc n feature type activation n expiry date null n metadata n is floating false n is floating cloud true n floating timeout 120 n floating users 1 n n n customer n email trial request n company name null n reference n phone n first name null n last name null n city n postcode n state n country n address n customer account null n metadata n n product details n product id 1584723961091040 n product name product1 n short code 1337 n authorization method license key n metadata n n metadata n is hardware key auth false n is air gapped false n floating users 1 n trial days 1 n n id 0ujeuvgav19ifssakozvk language 400 customlabel code selectedlanguageid 1jlwp1hw3a0 jxhz6u2 d request pathparameters queryparameters name hardware id kind required type string description unique hardware id generated for the client device children headerparameters name date kind required type string description in rfc7231 format see license api authorization eg thu 17 nov 2022 20 51 35 gmt children name authorization kind required type string description see license api authorization article children bodydataparameters formdataparameters currentnewparameter label query parameter value queryparameters schema request query parameters type licensesfordevicerequestparameters = { hardware id string } json schema { "$schema" "https //json schema org/draft/2020 12/schema", "type" "object", "properties" { "hardware id" { "type" "string" } }, "required" \["hardware id"], "additionalproperties" false } response body type licensesfordeviceresponsebody = type licenselistresponsebody = ({ id number, allow grace period boolean, allow overages boolean, allow unlimited activations boolean, borrowed until string | null, // in iso 8601 format (always in utc timezone), e g 2024 09 27t23 30 48 016z or 2024 09 27 23 30 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 signature v2 string, offline 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, company { id number }, 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 } }))\[]; 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" }, "channel" { "type" "string" }, "device id" { "type" "number" }, "enable maintenance period" { "type" "boolean" }, "environment" { "type" "string" }, "eula link" { "type" "string" }, "floating timeout" { "type" "number" }, "grace period" { "type" "number" }, "hash md5" { "type" "string" }, "installation file" { "type" "string" }, "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 signature v2" { "type" "string" }, "offline 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" }, "release date" { "type" "string" }, "release notes link" { "type" "string" }, "requires version" { "type" "string" }, "size" { "type" "string" }, "start date" { "type" \["string", "null"] }, "times activated" { "type" "number" }, "transfer count" { "type" "number" }, "validity period" { "type" \["string", "null"] }, "version" { "type" "string" }, "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" { "type" "object" }, "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" }, "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" { "type" "object" } }, "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" { "type" "object" } }, "required" \["product id", "product name", "short code", "authorization method", "metadata"] }, "metadata" { "type" "object" }, "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 signature v2", "offline 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 } ] } } 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