API reference
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
AuthorizationheaderrequiredBearerand 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
activeon 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
| Status | When |
|---|---|
| 400 | The key is missing or isn't a Ploba licence key. |
| 401 | The secret key is missing, revoked or expired. |
| 404 | No 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>" }'{
"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>"
}
}