Get a customer | FluxStore Docs

GET/api/v1/customers/{id}

Retrieve a single customer profile by its ID.

Personally identifiable information is not exposed through the Store Management API.

Requires the Customers:View permission.

Path parameters

idstring· uuidrequired

The customer ID.

Customer object

idstring· uuidrequired

The customer ID.

playerUsernamestringrequired

Player in-game name.

playerUuidstring· uuid

Minecraft UUID, if known.

totalSpentnumberrequired

Lifetime spend in the store currency.

ordersCountintegerrequired

Total number of completed orders.

lastPurchaseAtstring· date-time

Most recent purchase, or null.

createdAtstring· date-timerequired

First-seen timestamp.

GET/api/v1/customers/{id}


curl -H "X-Api-Key: flx_XXXX_XXXXXXXX" \
  https://api.fluxstore.net/api/v1/customers/cus_a1b2c3...

200OK


{
  "success": true,
  "data": {
    "id": "cus_a1b2c3...",
    "playerUsername": "Steve",
    "playerUuid": "069a79f4-...",
    "totalSpent": 124.95,
    "ordersCount": 7,
    "lastPurchaseAt": "2026-04-20T10:00:00Z",
    "createdAt": "2025-11-12T08:30:00Z"
  }
}