Get License Details

Retrieve detailed information about a specific license key (licenseKey), including its properties, activation status, associated devices, and linked customer data (if any).

Endpoint

POST /get-key

Base URL: https://docs/api.keymint.dev

Request

Send a POST request with a JSON body and Content-Type: application/json. Include the accessToken as a Bearer token in the Authorization header.

Headers

Body Parameters

Example Request

POST /get-key HTTP/1.1
Host: api.keymint.dev
Authorization: Bearer at_verylongaccesstokenstringgeneratedforyourapplication12345678
Content-Type: application/json

{
  "productId": "your_product_id_123",
  "licenseKey": "xxxxx-xxxxx-xxxxx-xxxxx"
}

Responses

The API returns a JSON object containing the license key and customer details.

Success Response (200 OK)

{
  "code": 0,
  "data": {
    "license": {
      "id": "lki_...",
      "key": "xxxxx-xxxxx-xxxxx-xxxxx",
      "product_id": "your_product_id_123",
      "max_activations": 5,
      "activations": 2,
      "devices": [
        {
          "host_id": "a1:b2:c3:d4:e5:f6-hashed-uuid-or-other-id",
          "device_tag": "Dev Workstation",
          "ip_address": "192.168.1.100",
          "activation_time": "2023-10-27T10:00:00Z"
        },
        {
          "host_id": "another-unique-device-identifier",
          "device_tag": "John's Laptop",
          "ip_address": "10.0.0.5",
          "activation_time": "2023-11-15T14:30:00Z"
        }
      ],
      "activated": true,
      "expiration_date": "2024-12-31T23:59:59Z"
    },
    "customer": {
      "id": "cust_...",
      "name": "Jane Doe",
      "email": "jane.doe@example.com",
      "active": true
    }
  }
}

Error Responses