Create License

Create License

curl --request POST \
  --url https://app.lukittu.com/api/v1/dev/teams/{teamId}/licenses \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "customerIds": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "productIds": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "suspended": true,
  "sendEmailDelivery": true,
  "metadata": [
    {
      "key": "<string>",
      "value": "<string>",
      "locked": true
    }
  ],
  "expirationDate": "2023-11-07T05:31:56Z",
  "expirationDays": 2,
  "ipLimit": 1,
  "hwidLimit": 2
}
'

import requests

url = "https://app.lukittu.com/api/v1/dev/teams/{teamId}/licenses"

payload = {
    "customerIds": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
    "productIds": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
    "suspended": True,
    "sendEmailDelivery": True,
    "metadata": [
        {
            "key": "<string>",
            "value": "<string>",
            "locked": True
        }
    ],
    "expirationDate": "2023-11-07T05:31:56Z",
    "expirationDays": 2,
    "ipLimit": 1,
    "hwidLimit": 2
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    customerIds: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
    productIds: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
    suspended: true,
    sendEmailDelivery: true,
    metadata: [{key: '<string>', value: '<string>', locked: true}],
    expirationDate: '2023-11-07T05:31:56Z',
    expirationDays: 2,
    ipLimit: 1,
    hwidLimit: 2
  })
};

fetch('https://app.lukittu.com/api/v1/dev/teams/{teamId}/licenses', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.lukittu.com/api/v1/dev/teams/{teamId}/licenses",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'customerIds' => [
        '3c90c3cc-0d44-4b50-8888-8dd25736052a'
    ],
    'productIds' => [
        '3c90c3cc-0d44-4b50-8888-8dd25736052a'
    ],
    'suspended' => true,
    'sendEmailDelivery' => true,
    'metadata' => [
        [
                'key' => '<string>',
                'value' => '<string>',
                'locked' => true
        ]
    ],
    'expirationDate' => '2023-11-07T05:31:56Z',
    'expirationDays' => 2,
    'ipLimit' => 1,
    'hwidLimit' => 2
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.lukittu.com/api/v1/dev/teams/{teamId}/licenses"

	payload := strings.NewReader("{\n  \"customerIds\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"productIds\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"suspended\": true,\n  \"sendEmailDelivery\": true,\n  \"metadata\": [\n    {\n      \"key\": \"<string>\",\n      \"value\": \"<string>\",\n      \"locked\": true\n    }\n  ],\n  \"expirationDate\": \"2023-11-07T05:31:56Z\",\n  \"expirationDays\": 2,\n  \"ipLimit\": 1,\n  \"hwidLimit\": 2\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.lukittu.com/api/v1/dev/teams/{teamId}/licenses")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"customerIds\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"productIds\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"suspended\": true,\n  \"sendEmailDelivery\": true,\n  \"metadata\": [\n    {\n      \"key\": \"<string>\",\n      \"value\": \"<string>\",\n      \"locked\": true\n    }\n  ],\n  \"expirationDate\": \"2023-11-07T05:31:56Z\",\n  \"expirationDays\": 2,\n  \"ipLimit\": 1,\n  \"hwidLimit\": 2\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.lukittu.com/api/v1/dev/teams/{teamId}/licenses")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"customerIds\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"productIds\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"suspended\": true,\n  \"sendEmailDelivery\": true,\n  \"metadata\": [\n    {\n      \"key\": \"<string>\",\n      \"value\": \"<string>\",\n      \"locked\": true\n    }\n  ],\n  \"expirationDate\": \"2023-11-07T05:31:56Z\",\n  \"expirationDays\": 2,\n  \"ipLimit\": 1,\n  \"hwidLimit\": 2\n}"

response = http.request(request)
puts response.read_body

{
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "licenseKey": "<string>",
    "suspended": true,
    "teamId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "createdByUserId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "ipLimit": 1,
    "hwidLimit": 2,
    "expirationDate": "2023-11-07T05:31:56Z",
    "expirationDays": 2,
    "metadata": [
      {
        "key": "<string>",
        "value": "<string>",
        "locked": true
      }
    ],
    "lastActiveAt": "2023-11-07T05:31:56Z",
    "customers": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "teamId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "createdByUserId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "createdAt": "2023-11-07T05:31:56Z",
        "updatedAt": "2023-11-07T05:31:56Z",
        "email": "jsmith@example.com",
        "fullName": "<string>",
        "username": "<string>",
        "metadata": [
          {
            "key": "<string>",
            "value": "<string>",
            "locked": true
          }
        ],
        "address": {
          "street": "<string>",
          "city": "<string>",
          "state": "<string>",
          "country": "<string>",
          "postalCode": "<string>"
        },
        "discordAccount": {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "customerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "discordId": "<string>",
          "username": "<string>",
          "createdAt": "2023-11-07T05:31:56Z",
          "updatedAt": "2023-11-07T05:31:56Z",
          "avatar": "<string>"
        }
      }
    ],
    "products": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>",
        "teamId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "createdByUserId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "createdAt": "2023-11-07T05:31:56Z",
        "updatedAt": "2023-11-07T05:31:56Z",
        "url": "<string>",
        "metadata": [
          {
            "key": "<string>",
            "value": "<string>",
            "locked": true
          }
        ]
      }
    ]
  },
  "result": {
    "timestamp": "2023-11-07T05:31:56Z",
    "valid": true,
    "details": "<string>"
  }
}

{
  "result": {
    "timestamp": "2023-11-07T05:31:56Z",
    "valid": false,
    "details": "<string>"
  },
  "data": {}
}

{
  "result": {
    "timestamp": "2023-11-07T05:31:56Z",
    "valid": false,
    "details": "<string>"
  },
  "data": {}
}

POST

api

dev

teams

{teamId}

licenses

Create License

curl --request POST \
  --url https://app.lukittu.com/api/v1/dev/teams/{teamId}/licenses \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "customerIds": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "productIds": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "suspended": true,
  "sendEmailDelivery": true,
  "metadata": [
    {
      "key": "<string>",
      "value": "<string>",
      "locked": true
    }
  ],
  "expirationDate": "2023-11-07T05:31:56Z",
  "expirationDays": 2,
  "ipLimit": 1,
  "hwidLimit": 2
}
'

import requests

url = "https://app.lukittu.com/api/v1/dev/teams/{teamId}/licenses"

payload = {
    "customerIds": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
    "productIds": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
    "suspended": True,
    "sendEmailDelivery": True,
    "metadata": [
        {
            "key": "<string>",
            "value": "<string>",
            "locked": True
        }
    ],
    "expirationDate": "2023-11-07T05:31:56Z",
    "expirationDays": 2,
    "ipLimit": 1,
    "hwidLimit": 2
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    customerIds: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
    productIds: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
    suspended: true,
    sendEmailDelivery: true,
    metadata: [{key: '<string>', value: '<string>', locked: true}],
    expirationDate: '2023-11-07T05:31:56Z',
    expirationDays: 2,
    ipLimit: 1,
    hwidLimit: 2
  })
};

fetch('https://app.lukittu.com/api/v1/dev/teams/{teamId}/licenses', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.lukittu.com/api/v1/dev/teams/{teamId}/licenses",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'customerIds' => [
        '3c90c3cc-0d44-4b50-8888-8dd25736052a'
    ],
    'productIds' => [
        '3c90c3cc-0d44-4b50-8888-8dd25736052a'
    ],
    'suspended' => true,
    'sendEmailDelivery' => true,
    'metadata' => [
        [
                'key' => '<string>',
                'value' => '<string>',
                'locked' => true
        ]
    ],
    'expirationDate' => '2023-11-07T05:31:56Z',
    'expirationDays' => 2,
    'ipLimit' => 1,
    'hwidLimit' => 2
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.lukittu.com/api/v1/dev/teams/{teamId}/licenses"

	payload := strings.NewReader("{\n  \"customerIds\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"productIds\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"suspended\": true,\n  \"sendEmailDelivery\": true,\n  \"metadata\": [\n    {\n      \"key\": \"<string>\",\n      \"value\": \"<string>\",\n      \"locked\": true\n    }\n  ],\n  \"expirationDate\": \"2023-11-07T05:31:56Z\",\n  \"expirationDays\": 2,\n  \"ipLimit\": 1,\n  \"hwidLimit\": 2\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.lukittu.com/api/v1/dev/teams/{teamId}/licenses")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"customerIds\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"productIds\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"suspended\": true,\n  \"sendEmailDelivery\": true,\n  \"metadata\": [\n    {\n      \"key\": \"<string>\",\n      \"value\": \"<string>\",\n      \"locked\": true\n    }\n  ],\n  \"expirationDate\": \"2023-11-07T05:31:56Z\",\n  \"expirationDays\": 2,\n  \"ipLimit\": 1,\n  \"hwidLimit\": 2\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.lukittu.com/api/v1/dev/teams/{teamId}/licenses")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"customerIds\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"productIds\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"suspended\": true,\n  \"sendEmailDelivery\": true,\n  \"metadata\": [\n    {\n      \"key\": \"<string>\",\n      \"value\": \"<string>\",\n      \"locked\": true\n    }\n  ],\n  \"expirationDate\": \"2023-11-07T05:31:56Z\",\n  \"expirationDays\": 2,\n  \"ipLimit\": 1,\n  \"hwidLimit\": 2\n}"

response = http.request(request)
puts response.read_body

{
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "licenseKey": "<string>",
    "suspended": true,
    "teamId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "createdByUserId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "ipLimit": 1,
    "hwidLimit": 2,
    "expirationDate": "2023-11-07T05:31:56Z",
    "expirationDays": 2,
    "metadata": [
      {
        "key": "<string>",
        "value": "<string>",
        "locked": true
      }
    ],
    "lastActiveAt": "2023-11-07T05:31:56Z",
    "customers": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "teamId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "createdByUserId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "createdAt": "2023-11-07T05:31:56Z",
        "updatedAt": "2023-11-07T05:31:56Z",
        "email": "jsmith@example.com",
        "fullName": "<string>",
        "username": "<string>",
        "metadata": [
          {
            "key": "<string>",
            "value": "<string>",
            "locked": true
          }
        ],
        "address": {
          "street": "<string>",
          "city": "<string>",
          "state": "<string>",
          "country": "<string>",
          "postalCode": "<string>"
        },
        "discordAccount": {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "customerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "discordId": "<string>",
          "username": "<string>",
          "createdAt": "2023-11-07T05:31:56Z",
          "updatedAt": "2023-11-07T05:31:56Z",
          "avatar": "<string>"
        }
      }
    ],
    "products": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>",
        "teamId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "createdByUserId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "createdAt": "2023-11-07T05:31:56Z",
        "updatedAt": "2023-11-07T05:31:56Z",
        "url": "<string>",
        "metadata": [
          {
            "key": "<string>",
            "value": "<string>",
            "locked": true
          }
        ]
      }
    ]
  },
  "result": {
    "timestamp": "2023-11-07T05:31:56Z",
    "valid": true,
    "details": "<string>"
  }
}

{
  "result": {
    "timestamp": "2023-11-07T05:31:56Z",
    "valid": false,
    "details": "<string>"
  },
  "data": {}
}

{
  "result": {
    "timestamp": "2023-11-07T05:31:56Z",
    "valid": false,
    "details": "<string>"
  },
  "data": {}
}

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

Body

application/json

customerIds

string<uuid>[]

required

Customer UUIDs to associate with this license

UUID v4 identifier

productIds

string<uuid>[]

required

Product UUIDs to associate with this license

UUID v4 identifier

expirationType

enum<string>

required

Defines how license expiration is calculated

Available options:

NEVER,

DATE,

DURATION

suspended

boolean

required

Whether to create the license in suspended state

sendEmailDelivery

boolean

required

Whether to send license details via email

metadata

object[]

required

Key-value metadata pairs

Show child attributes

expirationStart

enum<string> | null

Defines when the license expiration countdown begins

Available options:

CREATION,

ACTIVATION

expirationDate

string<date-time> | null

Required when expirationType is DATE

expirationDays

integer | null

Required when expirationType is DURATION

Required range: x >= 1

ipLimit

integer | null

Required range: x >= 0

hwidLimit

integer | null

Required range: x >= 1

Response

License created successfully

data

object

required

Response data

Show child attributes

result

object

required

Show child attributes

List Licenses Get License by ID

API Documentation

Client - Verify

Dev - Licenses

Dev - Releases

Dev - Customers

Dev - Statistics

Authorizations

Path Parameters

Body

Response