Quickstart: Activate a Device (5 minutes)

Last updated: Phase 8.5

Prerequisites

• A ValidonX API key
• A valid license key
• A unique instance identifier for the device

Step 1: Create the Activation

curl -X POST https://api.validonx.com/api/v1/integration/activations \
  -H "X-API-Key: vx_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "license_key": "YOUR-LICENSE-KEY",
    "instance_id": "device-unique-id",
    "metadata": {"os": "windows", "app_version": "3.0"}
  }'

Step 2: Check the Response

Success (201):

{
  "data": {
    "activation": {
      "id": 1,
      "license_key_id": 42,
      "instance_id": "device-unique-id",
      "device_fingerprint": "auto-generated-hash",
      "status": "active",
      "activated_at": "2026-03-30T10:00:00.000000Z"
    }
  },
  "meta": { "request_id": "uuid", "api_version": "1" }
}

Save the activation.id — you'll need it to validate the activation later.

Step 3: Validate Later

curl -X POST https://api.validonx.com/api/v1/integration/activations/1/validate \
  -H "X-API-Key: vx_your_api_key" \
  -H "Content-Type: application/json"

Safe to Retry

The activation endpoint is idempotent. If you call it twice with the same license_key + instance_id, you get the existing activation back (no duplicate).

Common Errors

Code	Meaning	Fix
LICENSE.NOT_FOUND	Bad license key	Verify the key
ACTIVATION.LIMIT_EXCEEDED	Too many devices	Deactivate unused devices or upgrade plan
ACTIVATION.INVALID	License not active	Check license status