Skip to main content
POST
/
license
/
validate
Validate License
curl --request POST \
  --url https://api.kelviq.com/api/v1/license/validate/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "licenseKey": "KLVQ-PRO-1234-ABCD-9999",
  "instanceId": "8f3e2b1a-5c6d-4e9f-8a0b-1c2d3e4f5g6h"
}
'
{
  "valid": true,
  "code": "VALID",
  "detail": "Instance ID valid for this license.",
  "metadata": {
    "os": "macOS",
    "arch": "arm64"
  },
  "license": {
    "id": "7be7a5b6-7a0e-4178-a085-8ef48f0649ab",
    "licenseKey": "LIC-A8D5F89E-B46B-472C-9BED-66EE2545B85E",
    "activatedOn": "2026-01-22T03:26:56Z",
    "expiresOn": "2026-01-23T03:26:56Z",
    "activationUsage": 1,
    "activationLimit": 4,
    "enabled": true,
    "customer": {
      "customerId": "cfa95cf8c8d24e8b9d3d2d1ada98a94d",
      "name": "Geo",
      "email": "geo@kelviq.com"
    },
    "plan": {
      "identifier": "pro-yearly",
      "name": "Pro Yearly",
      "product": {
        "id": "d970ab2d-834f-4c52-8742-2e6ed7e8a31f",
        "identifier": "kelviq-engine",
        "name": "Kelviq Engine",
        "taxCode": "software"
      }
    },
    "subscription": {
      "id": "09d706ca-58f3-4fb2-818f-5b8623d67e6e",
      "recurrence": "1 month",
      "billingPeriodStartTime": "2026-01-22T03:26:56Z",
      "billingPeriodEndTime": "2026-02-22T03:26:56Z",
      "startDate": "2026-01-22",
      "endDate": null,
      "status": "active",
      "amount": "49.00",
      "currency": "usd",
      "trialDaysRemaining": 0,
      "billingType": "SUBSCRIPTION",
      "recurrenceUnit": 1,
      "recurrenceType": "MONTH"
    }
  }
}

Authorizations

​
Authorization
string
header
required

The Server API Key obtained from the kelviq application. Pass as a Bearer token in the Authorization header. Example: 'Authorization: Bearer YOUR_API_KEY'

Body

application/json
​
licenseKey
string
required
​
instanceId
string<uuid>

Response

Validation successful

​
valid
boolean
​
code
string
​
detail
string
​
metadata
object
​
license
object