Skip to content
The Aggregator

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.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Query Parameters

Section titled “Query Parameters”
limit
integer
default: 50 >= 1 <= 100
offset
integer
0

Responses

Section titled “Responses”

200

Section titled “200”

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. On the outbound wallet callback these are delivered as a standard win/bet action carrying is_free: true — see the Free Rounds guide.

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.

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

401

Section titled “401”

Missing, invalid, or revoked API key.

object
error
required
object
code
required

Machine-parseable error code. See https://docs.aggregator.gg/resources/error-codes/.

string
/^E[0-9A-F][0-9]{3}$/
E0001
type

Snake-case mnemonic for the code (e.g. game_blocked_jurisdiction, player_self_excluded). Branch on code; type is for readability.

string
game_blocked_jurisdiction
message
required
string
request_id

Correlation ID for support escalation.

string
details
object
key
additional properties
any