Licensing
Validate Roblox license
Checks a Roblox license works for this person. Use it on player join or server start.
GET
/
v1
/
licenses
/
validate
curl "https://api.coveapp.cc/v1/licenses/validate?product=pro-kit&robloxId=100" \
-H "Authorization: Bearer $COVE_API_KEY"
{
"data": {
"valid": true,
"product": {
"id": "…",
"slug": "pro-kit",
"title": "Pro Kit",
"kind": "license",
"live": true
},
"user": {
"username": "prrent",
"roblox_id": "100",
"discord_id": "500"
},
"license": {
"id": "…",
"plan": "month",
"status": "active",
"borrowed": false,
"renews_at": "2026-12-01T…",
"ends_at": null,
"lent_until": null
}
}
}
Needs the
licensing:read permission on a store key.Call this when a player joins or when a server starts, so you always know the license is still good.
Identify the person with one of
robloxId, discordId or username.This only works on Roblox licenses. Calling it on any other kind of product returns a
400. Use Check ownership for those.string
required
The product’s id or slug.
string
Their Roblox user id.
string
Their Discord id.
string
Their Cove username.
curl "https://api.coveapp.cc/v1/licenses/validate?product=pro-kit&robloxId=100" \
-H "Authorization: Bearer $COVE_API_KEY"
{
"data": {
"valid": true,
"product": {
"id": "…",
"slug": "pro-kit",
"title": "Pro Kit",
"kind": "license",
"live": true
},
"user": {
"username": "prrent",
"roblox_id": "100",
"discord_id": "500"
},
"license": {
"id": "…",
"plan": "month",
"status": "active",
"borrowed": false,
"renews_at": "2026-12-01T…",
"ends_at": null,
"lent_until": null
}
}
}
Response
object
The result of the check.
Hide properties
Hide properties
boolean
Whether the license works for this person.
string
Why it isn’t valid. Only there when
valid is false. See the table below.object
object
object
Their license for this product.
Show license
Show license
string
The license’s id.
string
The plan it is on, like
month.string
The license’s status, like
active.boolean
Whether this person is borrowing it from someone else.
string | null
When the subscription renews, as an ISO date.
string | null
When the license ends, as an ISO date, if it does.
string | null
When a lent license comes back, as an ISO date, if it is lent.
Reasons a license isn’t valid
Whenvalid is false, reason is one of:
| Reason | Meaning |
|---|---|
not_owned | They don’t have this license. |
lent_out | They own it but lent it to someone else. |
paused_payment | A subscription payment failed. |
paused_dispute | A card dispute is open. |
ended | The subscription ended. |
revoked | The seller revoked it. |
no_cove_account | No Cove account with that ID. |
Last modified on November 4, 2026
Was this page helpful?
⌘I
curl "https://api.coveapp.cc/v1/licenses/validate?product=pro-kit&robloxId=100" \
-H "Authorization: Bearer $COVE_API_KEY"
{
"data": {
"valid": true,
"product": {
"id": "…",
"slug": "pro-kit",
"title": "Pro Kit",
"kind": "license",
"live": true
},
"user": {
"username": "prrent",
"roblox_id": "100",
"discord_id": "500"
},
"license": {
"id": "…",
"plan": "month",
"status": "active",
"borrowed": false,
"renews_at": "2026-12-01T…",
"ends_at": null,
"lent_until": null
}
}
}