IMPORTANT: Active updates are ending! For more information, please visit our Discord server.

Skip to main content

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.

Contents