Skip to main content
GET
/
validate
/
{pluginId}
/
{key}
Validate a license key
curl --request GET \
  --url https://api.mclicense.org/validate/{pluginId}/{key}
{
  "pluginId": "<string>",
  "message": "<string>",
  "key": "<string>",
  "status": "valid",
  "nonce": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "signature": "<string>"
}

Path Parameters

​
pluginId
string
required

Plugin ID on dashboard

​
key
string
required

License key to validate (alphanumeric + hyphens, max 36 chars)

Query Parameters

​
sessionId
string<uuid>
required

Unique ID for heartbeat tracking (UUID format)

​
nonce
string
required

Unique ID for request to prevent replay attacks (UUID format)

Response

200 - application/json

License validation response

​
pluginId
string
required

The plugin ID that was validated

​
message
string
required

Human-readable message about the validation result

​
key
string
required

The license key that was validated (alphanumeric + hyphens, max 36 chars)

​
status
enum<string>
required

Status code of the validation result

Available options:
valid,
invalid_format,
not_found,
expired,
max_ips,
blacklisted,
disabled,
invalid_polymart,
server_error
​
nonce
string<uuid>
required

The nonce that was provided in the request

​
signature
string
required

Base64-encoded RSA signature of the response data