Activation Lifecycle

Activations represent a license key being used on a specific device or environment. ValidonX tracks activations to enforce per-license limits and provide usage visibility.

Lifecycle States

License Issued → Activation Created → Activation Validated → (Activation Revoked)

Creating an Activation

Endpoint: POST /v1/integration/activations

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": "VALIDONX-XXXX-XXXX-XXXX-XXXX",
    "fingerprint": "device-unique-identifier",
    "metadata": {
      "os": "Windows 11",
      "app_version": "2.1.0",
      "hostname": "workstation-01"
    }
  }'

Response (201):

{
  "data": {
    "activation_id": "uuid",
    "license_key": "VALIDONX-XXXX-XXXX-XXXX-XXXX",
    "fingerprint": "device-unique-identifier",
    "status": "active",
    "created_at": "2026-04-03T10:00:00Z"
  },
  "meta": { "request_id": "uuid", "api_version": "1" }
}

Validating an Activation

Endpoint: POST /v1/integration/activations/{activationId}/validate

Use this to verify an activation is still valid (not revoked, license not expired).

curl -X POST https://api.validonx.com/api/v1/integration/activations/{id}/validate \
  -H "X-API-Key: VX-your-api-key"

Idempotency

Creating an activation with the same license_key + fingerprint combination returns the existing activation rather than creating a duplicate. This makes the endpoint safe to retry.

Activation Limits

Each license has a maximum number of activations (configurable, default 10). When the limit is reached, new activation requests return 403 ACTIVATION.LIMIT_EXCEEDED.

Plan	Default Max Activations
Starter	10 per license
Pro	50 per license
Enterprise	Configurable

Best Practices

1. Generate stable fingerprints: Use a combination of hardware identifiers (CPU ID, disk serial, MAC address) hashed together
2. Validate on startup: Check activation validity when your application starts
3. Handle gracefully: If activation fails, show a user-friendly message with instructions
4. Include metadata: OS, app version, and hostname help with debugging and analytics