Skip to content

Open app

List transactions

GET
/transactions

List your most recent wallet transactions (bets, wins, refunds), newest first. Used for reconciliation against your wallet ledger and for debugging an integration: every row echoes your own wallet’s reply (operator_response, operator_status) so you can see why a transaction failed without contacting support.

Pagination is limit + offset only. There is no server-side filtering yet - filter client-side after fetching.

limit
integer
default: 50 >= 1 <= 100
offset
integer
0

Page of transactions.

object
transactions
required
Array<object>
object
id
required
string format: uuid
session_id
required
string format: uuid
operator_user_id

Your operator account id (rows are always scoped to the caller).

string
transaction_type
required

Ledger transaction type. freespin is a free-round win credit and free_round_use the (zero-stake) free-round consumption (ADR-048). On the outbound wallet callback these are delivered as a standard win/bet action carrying is_free: true (operator-wallet-v1.1) - see the operator Free Rounds integration guide. Mobule’s free_round_use rows (an activation of a game’s rounds, or a cancel’s tombstone; amount 0) have no wallet callback: only a positive freespin win is sent (a zero win is recorded without one).

string
Allowed values: bet win refund freespin free_round_use
amount
required

Amount as an INTEGER in minor units (150 = 1.50 EUR) - the same unit as the wallet-callback amount and the balance your wallet returns. Always non-negative; transaction_type discriminates direction. null only when the stored value could not be parsed (defensive; not expected in practice).

integer
nullable
currency
required
string
provider_code
string
provider_transaction_id

Provider-unique transaction id - matches the transaction_id of the wallet callback you received for this movement. Mobule free-round rows carry our own ids: freerounds:<id>:complete is the freespin win’s (the WIN you received), and freerounds:<id>:activate marks an activation or a cancel’s tombstone, neither of which has a callback.

string
status

Lifecycle status. Typical values: completed, failed, cancelled, permanent_error. Not a closed set - treat unknown values as non-final.

string
operator_status

HTTP status returned by your callback handler (null when the forward never reached your endpoint).

integer
nullable
operator_response

Your wallet’s own JSON reply, echoed back for debugging.

object
key
additional properties
any
processing_time_ms
integer
nullable
error_message
string
nullable
environment
string
Allowed values: test live
created_at
required
string format: date-time
limit
required
integer
offset
required
integer

Missing, invalid, or revoked API key.

object
error
required
object
code
required

Machine-parseable error code. See https://hub.aggregator.gg/error-reference/.

string
/^(E[0-9A-F][0-9]{3}|PROVIDER_ACCESS_REQUIRED|PROVIDER_ACCESS_UNAVAILABLE)$/
E0001
message
required
string
request_id

Correlation ID for support escalation.

string
details
object
key
additional properties
any