Getting started

Integrate LicensHub into your app in under 10 minutes.

Quickstart

Install the SDK for your language, grab your API key from the dashboard, and make your first license verification call.

1
Install the SDK

Pick your language from the SDKs page and install the package.

2
Get your API key

Find your API key in the LicensHub dashboard under Settings → API Keys.

3
Verify a license

Call client.verify(licenseKey) and check the valid field in the response.

Authentication

All API requests require a Bearer token in the Authorization header. Keep your API key secret — never expose it in client-side code.

Authorization: Bearer YOUR_API_KEY

Core Concepts

License Key

A unique string (e.g. LK-XXXX-YYYY-ZZZZ) that identifies an entitlement. Issued per customer, per product.

Activation

A record of a license being used on a specific device. Hardware binding ties activations to device fingerprints.

Product

A logical grouping for licenses. Each product has its own activation limits, expiry rules, and feature flags.

Offline Token

A short-lived signed JWT that allows license verification without internet access, for a configurable grace period.

Verifying Licenses

The verify endpoint returns a valid boolean plus metadata. Always check valid — never trust the presence of a key alone.

// Node.js example
import { LicensHub } from '@licenshub/sdk'

const lh = new LicensHub('YOUR_API_KEY')
const result = await lh.verify('LICENSE_KEY')

if (!result.valid) {
  // show license expired / invalid UI
}