Get a ban | FluxStore Docs

GET/api/v1/bans/{id}

Retrieve a single ban by its ID.

Requires the Bans:View permission.

Path parameters

idstring· uuidrequired

The ban ID.

Ban object

idstring· uuidrequired

The ban ID.

playerUsernamestring

Banned player’s name (present if banned by username).

playerUuidstring· uuid

Banned player’s UUID (only if banned by username).

ipAddressstring

Banned IP address (present if banned by IP).

reasonstringrequired

Reason for the ban.

expiresAtstring· date-time

Ban expiry timestamp; null means permanent.

isActivebooleanrequired

Whether the ban is currently in effect.

createdAtstring· date-timerequired

Creation timestamp.

updatedAtstring· date-timerequired

Last update timestamp.

GET/api/v1/bans/{id}


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

200OK


{
  "success": true,
  "data": {
    "id": "ban_a1b2c3...",
    "playerUsername": "griefer123",
    "playerUuid": "069a79f4-...",
    "ipAddress": null,
    "reason": "Chargeback fraud",
    "expiresAt": null,
    "isActive": true,
    "createdAt": "2026-03-15T10:00:00Z",
    "updatedAt": "2026-03-15T10:00:00Z"
  }
}