POST
/
api
/
v1
/
client
/
teams
/
{teamId}
/
verification
/
verify
curl --request POST \
  --url https://app.lukittu.com/api/v1/client/teams/{teamId}/verification/verify \
  --header 'Content-Type: application/json' \
  --data '{
  "licenseKey": "<string>",
  "customerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "productId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "challenge": "<string>",
  "version": "<string>",
  "deviceIdentifier": "<string>"
}'
{
  "data": {},
  "result": {
    "timestamp": "2023-11-07T05:31:56Z",
    "valid": true,
    "details": "<string>",
    "code": "VALID",
    "challengeResponse": "<string>"
  }
}

Path Parameters

​
teamId
string
required

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

Body

application/json
​
licenseKey
string
required

The Lukittu license key. Lukittu license keys always follow this format: XXXXX-XXXXX-XXXXX-XXXXX-XXXXX where X is an uppercase letter (A-Z) or a digit (1-9).

​
customerId
string

The customer's UUID (UUID v4). This parameter is useful when a license key is shared among multiple customers, as it allows you to identify individual customers. Note: If strict customers are enabled in your team settings and the license has at least one customer attached, you must provide this value.

​
productId
string

The product's UUID (UUID v4). This binds the license key to a specific Lukittu product. Note: If strict products are enabled in your team settings and the license has at least one product attached, you must provide this value.

​
challenge
string

A client-generated random string used to prevent request interception. The Lukittu backend signs this challenge with its RSA private key. You can then validate the challenge using the corresponding public key. Recommendation: Always use a challenge for enhanced security, though it is not strictly required.

Maximum length: 1000
​
version
string

The version number of your Lukittu product. Useful for tracking which product releases are actively being used. Version must not contain spaces and must be between 3 and 255 characters.

Required string length: 3 - 255
​
deviceIdentifier
string

A unique identifier for the client device. Typically a hardware ID or another identifier that remains consistent across sessions. Device identifier must not contain spaces and must be between 10 and 1000 characters.

Required string length: 10 - 1000

Response

200
application/json
​
data
object
required
​
result
object
required