🎁 Description

🎯 Command fsStatus – Read the state of your free rounds / feature spins grants. Also known as command 32.

Read-only. Returns the grants your operator made with grantfs; another operator's grants read NOT FOUND.

Send at least one of uniqid / login.

📜 Sample JSON Request (from your server to the RGS-CWS server)
{"command":"fsStatus","uniqid":"promo-2026-10-15-0001","apiusername":"your_api_username","apipass":"your_api_password"}
📥 Input Parameters (from your server to the RGS-CWS server)

Parameter

Mandatory

Description

Type

*command

✅

fsStatus (or 32)

string

uniqid

one of the two

The unique grant id you sent to grantfs

string

login

one of the two

The player's login: every grant of that player (newest first, up to 200). Send the bare login; replies on the staging environment show it prefixed stg_u<operatorid>_<login>

string

fs_type

❌

freebet or feature_spins — any other value is refused

string

status

❌

pending · active · played · cancelled · expired

string

*apiusername

✅

Your API username

string

*apipass

✅

Your API password

string

📃 Sample JSON Response (returned by RGS-CWS)
{"status":"OK","count":1,"grants":[{"grant_id":1971,"uniqid":"promo-2026-10-15-0001","fs_type":"feature_spins","login":"player1","gameid":9754,"spins_granted":5,"spins_played":5,"spins_left":0,"bet":"1.000","lines":5,"fs_mult":1,"currency":"EUR","status":"cancelled","won_so_far":"33.500","settled":1,"settled_amount":"33.500","unsettled_amount":"0.000","wallet_ref":"…G99764","round_id":99764,"granted_at":"2026-10-15 17:20:01","expiry_date":"2026-10-16"}]}

Reply {"status":"OK","count":N,"grants":[…]} — one object per grant: grant_id (the freespins_id grantfs returned) · uniqid · fs_type · login (on staging prefixed stg_u<operatorid>_<login>) · gameid · spins_granted · spins_played · spins_left · bet · lines · fs_mult (feature_spins only, else null; 0 = the game's own multiplier, not yet played — once the feature is played it shows the multiplier the round actually used, EG 1) · currency · status · won_so_far · settled (1 = the round is closed and its win has reached your wallet) · settled_amount (the amount your wallet accepted) · unsettled_amount (a win sent but not yet accepted) · wallet_ref (the transaction token of the win sent to your wallet) · round_id · granted_at · expiry_date. Money values have at most 3 decimals.

status: pending not started · active started, spins left · played every spin played · cancelled stopped by cancelfs (spins already played are paid) · expired the expiry date passed with spins left.

❌ Errors (status: ERROR): NOT FOUND · Send uniqid … or login … · Unknown fs_type: send freebet or feature_spins … · status must be one of … · uniqid is at most 190 characters.