Verify a licence key

Check that a licence key is active for one of your organisation's products before you serve the request.

POSThttps://api.ploba.app/api/v1/external/developer/verify-license

Authorization

Authorizationheaderrequired
Bearer and a secret key. See Authentication.

Body

licenseKeystringrequired
The licence key your user received when they subscribed to your product.

Response

200 The licence is active. data holds:

idstring
The licence.
statusstring
Always active on success.
plan_tierstring
The plan the user subscribed to.
appId · appName · appSlugstring
Which of your products the key belongs to.
issued_at · expires_attimestamp
When the licence started and when it ends.

Errors

StatusWhen
400The key is missing or isn't a Ploba licence key.
401The secret key is missing, revoked or expired.
404No active licence with that key for your organisation.
curl -X POST https://api.ploba.app/api/v1/external/developer/verify-license \
  -H "Authorization: Bearer $PLOBA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "licenseKey": "<the user's licence key>" }'
Response
{
  "message": "License verified successfully",
  "code": "00",
  "success": true,
  "data": {
    "id": "<licence id>",
    "status": "active",
    "plan_tier": "<plan>",
    "appId": "<product id>",
    "appName": "Your MCP server",
    "appSlug": "your-mcp-server",
    "issued_at": "<timestamp>",
    "expires_at": "<timestamp>"
  }
}

Last updated Oct 9, 2026Report a problem with this page