Quickstart Guide

Get up and running with ValidonX in 5 minutes. By the end of this guide, you'll have created a product, issued a license key, and validated it via the API.

1. Create Your Account

Visit validonx.com/register and sign up with your email and company name. The Starter plan is free — no credit card required.

2. Provision Your Workspace

After registration, you'll be guided through the onboarding wizard:

1. Enter your company name
2. Select a plan (Starter is free)
3. Your workspace is provisioned automatically

Save your API key — it's shown only once during provisioning.

3. Create a Product

Navigate to Products in your dashboard and create your first product:

• Name: My SaaS App
• Code: my-saas-app

4. Issue a License Key

Navigate to Licenses and create a new license key for your product. The key format is: VALIDONX-XXXX-XXXX-XXXX-XXXX

5. Validate the License via API

curl -X POST https://api.validonx.com/api/v1/integration/licenses/VALIDONX-XXXX-XXXX-XXXX-XXXX/validate \
  -H "X-API-Key: VX-your-api-key-here" \
  -H "Content-Type: application/json"

Response:

{
  "data": {
    "valid": true,
    "license": {
      "status": "active",
      "product": "my-saas-app",
      "expires_at": null,
      "entitlements": {
        "plan": "free"
      }
    }
  },
  "meta": {
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "api_version": "1"
  }
}

6. Create an Activation

curl -X POST https://api.validonx.com/api/v1/integration/activations \
  -H "X-API-Key: VX-your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "license_key": "VALIDONX-XXXX-XXXX-XXXX-XXXX",
    "fingerprint": "my-device-001",
    "metadata": {"os": "macOS", "app_version": "1.0.0"}
  }'

What's Next?

• Integration Guide — PHP and JavaScript code examples
• Entitlements & Usage — Feature flags and usage metering
• Webhook Guide — Real-time event notifications
• OpenAPI Spec — Full OpenAPI specification
• Error Codes — Complete error code reference