---
title: "Activate a software license"
method: POST
path: "/license/activate"
tags: ["Licensing"]
---

# Activate a software license

`POST /license/activate`

## Request

- Base URL: `https://demo.onlinebillingform.com/api/v2`
- URL: `https://demo.onlinebillingform.com/api/v2/license/activate`
- Auth: none required
- TypeScript: <https://skmtc.dev/billingserv/apis/billingserv-api-v2/docs/license/activate/post.ts> (a function with typed inputs; its response is checked against the schema)

Registers a device or server installation against a license key. Server installations are bound to the configured domain, IP address, and installation-path policies. The license key is the credential; no bearer token is required.

## Request body

- LicenseActivationRequest
  - `license_key` string, required
  - `instance` string, required: Stable device UUID or server installation identifier.
  - `instance_type` 'device' | 'server', required
  - `domain` string, nullable: Required for server activations.
  - `installation_path` string, nullable: Required for server activations.
  - `device_name` string, nullable
  - `operating_system` string, nullable
  - `application_version` string, nullable

## Response `200`

License activated or existing activation refreshed

- LicenseActivationResponse
  - `success` true, required
  - `activated` boolean, required
  - `instance` string, required
  - `instance_type` 'device' | 'server' | 'null', nullable, required
  - `domain` string, nullable, required
  - `activations_used` integer, required
  - `activation_limit` integer, nullable, required

## Other responses

- `403`: License is suspended, expired, deactivated, or registered to a different installation
- `404`: License key not found
- `422`: Validation failed or the activation limit was reached
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/billingserv/apis/billingserv-api-v2.md) - [All operations](https://skmtc.dev/billingserv/apis/billingserv-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/billingserv/apis/billingserv-api-v2/revisions/232ab5ca8413?raw)