Skip to main content
  • Queries grants by event and channel, with optional member filter and paging.

Path

Headers

FieldTypeRequiredDescription
AuthorizationstringYesToken we provide

Request parameters

FieldTypeRequiredSignedDescription
channelIDnumberYes✓Channel ID (use 1 if you have no channels)
eventIDstringYes✓Event ID (24-character hex)
memberAccountstringNo✓Member account (allowed characters: a-z A-Z 0-9 _-)
nextTokenstringNo✓Query token (empty on the first query, then the nextToken from the previous result)
maxResultsnumberYes✓Maximum number of results (min 2000, max 5000)
signstringYesSignature. See Signature for how to generate it

Response

Success (the HTTP status code is always 200; check status.code for the result)
FieldTypeDescription
dataobject
data.grantListobject[]Grants
data.grantList[].eventIDstringEvent ID
data.grantList[].grantIDstringGrant ID
data.grantList[].channelIDnumberChannel ID
data.grantList[].memberAccountstringMember account
data.grantList[].statusstringStatus (New / Active / Completed / Freeze / Expired / SettleFailed)
data.grantList[].totalSpinTimesnumberFree spins given when granted
data.grantList[].usedSpinTimesnumberSpins used
data.grantList[].paidAmountnumberTotal payout credited to the wallet
data.grantList[].paidCountnumberNumber of payouts
data.grantList[].grantedAtstringGrant creation time (see Time format)
data.grantList[].completedAtstringCompletion time, empty if not completed (see Time format)
data.grantList[].frozenAtstringFreeze time, empty if not frozen (see Time format)
data.grantList[].expiredAtstringExpiry time (see Time format)
data.nextTokenstringToken for the next query (empty string on the last page)
data.maxResultsnumberMaximum number of results returned
data.totalnumberTotal number of records in this query
statusobjectResponse status. See Response format

Response example

Response codes

Besides the common codes, this API may also return: