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

# Activate a software license

`POST /license/activate`

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.net/b-cdn/apis/billingserv-api-v2.md) · [All operations](https://skmtc.net/b-cdn/apis/billingserv-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/b-cdn/billingserv-api-v2/revisions/76cfbed5eb40/schema)