Skip to main content
The max_activations setting on your license product controls how many devices (or IPs) can use a single license key.

​
Activation Limits

SettingBehavior
1One device only. A second device is rejected.
3Up to three devices. The fourth is rejected.
0 or emptyUnlimited activations.

​
Auto-Activation Flow

There is no separate “activate” API call. The /verify endpoint handles activation automatically:
1

First verification

A call with hwid: "machine-A" activates the device and returns a valid response. Slot 1 is used.
2

Same device again

Another call with hwid: "machine-A" returns valid. The device is already activated — the call is idempotent and does not consume an additional slot.
3

New device

A call with hwid: "machine-B" activates the second device. Slot 2 is used.
4

Limit reached

If max_activations is reached and a new HWID or IP calls verify, the API returns the ACTIVATION_LIMIT error (HTTP 429).

​
ACTIVATION_LIMIT Error

When all slots are used, the API responds with: 
{
  "success": false,
  "error": "ACTIVATION_LIMIT",
  "message": "Activation limit reached"
}
The customer needs to either:
  • Use a device that is already activated
  • Ask the store owner to reset their activations
  • Purchase an additional license

​
Resetting Activations

Store owners can reset all device activations for a license key from the dashboard:
  1. Go to your store dashboard
  2. Navigate to Licenses
  3. Find the license key (use search or filters)
  4. Click the row actions menu
  5. Select Reset Activations
This frees all activation slots immediately. The next verification call from any device will re-activate it.
Resetting activations is useful when a customer gets a new computer, reinstalls their OS, or changes their server IP. It does not affect the license validity or expiry date.

​
Activation Data in Responses

Every successful verification response includes activation counts: 
{
  "activations": {
    "current": 1,
    "max": 3,
    "remaining": 2
  }
}
FieldDescription
currentNumber of devices currently activated
maxMaximum allowed (null if unlimited)
remainingSlots left (null if unlimited)
Use this data to show your users how many devices they have left, or to warn them when they are approaching the limit.