List Licenses

List Licenses

curl --request GET \
  --url https://app.lukittu.com/api/v1/dev/teams/{teamId}/licenses \
  --header 'Authorization: Bearer <token>'

{
  "data": {
    "licenses": [
      {
        "id": "456e7890-e89b-12d3-a456-426614174111",
        "licenseKey": "ABCD1-EFGH2-IJKL3-MNOP4-QRST5",
        "expirationType": "NEVER",
        "suspended": false,
        "ipLimit": null,
        "hwidLimit": null,
        "metadata": [],
        "teamId": "123e4567-e89b-12d3-a456-426614174000",
        "createdByUserId": "789e0123-e89b-12d3-a456-426614174222",
        "createdAt": "2023-09-15T14:30:00Z",
        "updatedAt": "2023-09-15T14:30:00Z",
        "lastActiveAt": null
      }
    ],
    "hasNextPage": false
  },
  "result": {
    "timestamp": "2023-09-15T14:30:00Z",
    "valid": true,
    "details": "Licenses retrieved successfully"
  }
}

GET

api

dev

teams

{teamId}

licenses

List Licenses

curl --request GET \
  --url https://app.lukittu.com/api/v1/dev/teams/{teamId}/licenses \
  --header 'Authorization: Bearer <token>'

{
  "data": {
    "licenses": [
      {
        "id": "456e7890-e89b-12d3-a456-426614174111",
        "licenseKey": "ABCD1-EFGH2-IJKL3-MNOP4-QRST5",
        "expirationType": "NEVER",
        "suspended": false,
        "ipLimit": null,
        "hwidLimit": null,
        "metadata": [],
        "teamId": "123e4567-e89b-12d3-a456-426614174000",
        "createdByUserId": "789e0123-e89b-12d3-a456-426614174222",
        "createdAt": "2023-09-15T14:30:00Z",
        "updatedAt": "2023-09-15T14:30:00Z",
        "lastActiveAt": null
      }
    ],
    "hasNextPage": false
  },
  "result": {
    "timestamp": "2023-09-15T14:30:00Z",
    "valid": true,
    "details": "Licenses retrieved successfully"
  }
}

Authorizations

Authorization

string

header

required

API key authentication for development endpoints.

You can create API keys in your team's settings on the Lukittu dashboard. Include the API key in the Authorization header as: Bearer YOUR_API_KEY

Example:

Authorization: Bearer lukittu_api_key_abc123def456...

Path Parameters

teamId

string<uuid>

required

Your team's UUID. You can find this value in your team's settings on the Lukittu dashboard. UUID v4 identifier

Query Parameters

page

integer

default:1

Page number for pagination (1-based)

Required range: x >= 1

pageSize

enum<integer>

default:25

Number of items per page

Available options:

10,

25,

50,

100

sortColumn

enum<string>

default:createdAt

Column to sort by

Available options:

createdAt,

updatedAt

sortDirection

enum<string>

default:desc

Sort direction

Available options:

asc,

desc

productIds

string

Comma-separated list of product UUIDs to filter by

customerIds

string

Comma-separated list of customer UUIDs to filter by

Response

Licenses retrieved successfully

data

object

required

Response data

Show child attributes

data.licenses

object[]

required

Show child attributes

data.licenses.id

string<uuid>

required

Unique license identifier

data.licenses.licenseKey

string

required

Lukittu license key format: XXXXX-XXXXX-XXXXX-XXXXX-XXXXX where X is an uppercase letter (A-Z) or digit (0-9)

data.licenses.expirationType

enum<string>

required

Defines how license expiration is calculated

Available options:

NEVER,

DATE,

DURATION

data.licenses.suspended

boolean

required

Whether the license is suspended

data.licenses.teamId

string<uuid>

required

Team that owns this license

data.licenses.createdByUserId

string<uuid>

required

User who created this license

data.licenses.createdAt

string<date-time>

required

License creation timestamp

data.licenses.updatedAt

string<date-time>

required

License last update timestamp

data.licenses.ipLimit

integer | null

Maximum number of different IP addresses that can use this license

Required range: x >= 0

data.licenses.hwidLimit

integer | null

Maximum number of different hardware IDs that can use this license

Required range: x >= 1

data.licenses.expirationStart

enum<string>

Defines when the license expiration countdown begins

Available options:

CREATION,

ACTIVATION

data.licenses.expirationDate

string<date-time> | null

Specific expiration date (when expirationType is DATE)

data.licenses.expirationDays

integer | null

Number of days until expiration (when expirationType is DURATION)

Required range: x >= 1

data.licenses.metadata

object[]

Key-value metadata pairs

Show child attributes

data.licenses.metadata.key

string

required

Metadata key

data.licenses.metadata.value

string

required

Metadata value

data.licenses.metadata.locked

boolean

required

Whether this metadata field is locked from client modification

data.licenses.lastActiveAt

string<date-time> | null

Last activity timestamp for this license

data.hasNextPage

boolean

required

Whether more pages are available

result

object

required

Show child attributes

result.timestamp

string<date-time>

required

Timestamp when the response was generated

result.valid

enum<boolean>

required

Indicates whether the operation was successful Always true for success responses

Available options:

true,

false

result.details

string

required

Human-readable description of the result

Download Release Create License

⌘I

API Documentation

Client - Verify

Dev - Licenses

Dev - Customers

Authorizations

Path Parameters

Query Parameters

Response