get/key?productId=<PRODUCT_ID>&licenseKey=<LICENSE_KEY>

Get Key Info

Retrieve details, usage metrics, and status of a specific license key. Requires a read-only or admin API key, or any key with the license:read grant; read-only responses mask raw license keys and device IPs.

Authentication required: Bearer Token in Authorization header.

Parameters

productIdrequired

querystring

Product ID

Example<PRODUCT_ID>

licenseKeyrequired

querystring

License key

Example<LICENSE_KEY>

Responses

200Successfully retrieved license key information

Response Body (200)

data

object

code

integer

Request Example

curl -X GET "https://api.keymint.dev/key?productId=%3CPRODUCT_ID%3E&licenseKey=%3CLICENSE_KEY%3E" \
  -H "Authorization: Bearer <YOUR_API_KEY>"

Response (200 OK)

{
  "data": {
    "license": {
      "id": "wrl8Xq5v8dfGEQYe9bTcvT",
      "key": "GG6GM-ZMN6C-AWMQQ-2A5X5",
      "productId": "hycTLK3n85j3UbWYF08fsO",
      "maxActivations": null,
      "activations": 1,
      "activated": true,
      "expirationDate": null,
      "metadata": {
        "features": {},
        "is_trial": false
      },
      "allowedHosts": null,
      "licenseType": "node-locked",
      "maxConcurrentSessions": null,
      "heartbeatInterval": 60,
      "sessionLeaseDuration": 300,
      "customerCanSelfReset": true,
      "vendorDisabled": false,
      "devices": [
        {
          "id": "TyqX7jyXsEqHsEATHJpVl6",
          "hostId": "dev-machine-01",
          "deviceTag": "N/A",
          "ipAddress": "102.176.94.191",
          "activationTime": "2026-08-18T01:04:00.642Z"
        }
      ],
      "versionId": null,
      "version": null,
      "createdAt": "2026-08-15T23:22:24.208Z",
      "updatedAt": "2026-08-15T23:22:24.216Z"
    },
    "customer": null
  },
  "code": 0
}