List customers | FluxStore Docs

GET/api/v1/customers

List customers in the store. Paginated and sortable. Read-only.

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

Requires the Customers:View permission.

Query parameters

searchstring

Filter by player username (case-insensitive contains match).

sortBystring

Sort field. Defaults to lastPurchaseAt.

Values:: totalSpentlastPurchaseAtcreatedAt

sortDescboolean

Sort descending. Defaults to true.

skipinteger

Results to skip. Defaults to 0.

takeinteger

Page size, max 100. Defaults to 20.

Headers

X-Api-Keystringrequired

Your API key.

GET/api/v1/customers


curl -H "X-Api-Key: flx_XXXX_XXXXXXXX" \
  "https://api.fluxstore.net/api/v1/customers?sortBy=totalSpent&sortDesc=true"

200OK


{
  "success": true,
  "data": {
    "items": [
      {
        "id": "cus_a1b2c3...",
        "playerUsername": "Steve",
        "totalSpent": 124.95,
        "ordersCount": 7,
        "lastPurchaseAt": "2026-04-20T10:00:00Z"
      }
    ],
    "total": 1,
    "skip": 0,
    "take": 20
  }
}