Account Customer Status
Last updated March 13, 2026
Check whether an account is an active customer.
Endpoint
1GET /api/v1/account/:id
Description
Returns whether the given account currently owns at least one valid license key. A "valid" key is one with a status of active (bound to a device and running) or inactive (purchased but not yet activated). Keys that are expired or revoked are not counted.
This is useful for verifying whether a user has paid access before granting entry to a service, Discord role, or external integration, without exposing any personal or financial information.
Path Parameters
id(string UUID, required): The user's account ID
Rate Limit
- 5 requests per 60 seconds per IP address
Headers
Rate-limit headers are included in every response:
1X-RateLimit-Limit: 5 X-RateLimit-Remaining: 4 X-RateLimit-Reset: 2026-03-01T12:34:56.789Z
Example Request
1curl -X GET https://krx.gg/api/v1/account/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Success Response
Status: 200 OK
1{
"isCustomer": true
}
Error Responses
404 Not Found
The provided ID is not a valid UUID or does not correspond to any account.
1{
"error": "Not Found"
}
429 Too Many Requests
1{
"error": "Too Many Requests",
"message": "Rate limit exceeded. Please try again later.",
"retryAfter": 45
}
Notes
- The account ID can be found by the user in their Account Settings page.
- No personal data (name, email, balances, etc.) is ever returned by this endpoint.
- An account that exists but has no keys returns
{ "isCustomer": false }— not a 404.
Have questions? Reach out to us on Discord.