History

GET /api/s2s/history returns a player’s transaction ledger for reconciliation, support, and statements. It spans every money-affecting event LootBox Solutions records.

Request

GET https://{operator}.app.lootboxsolutions.com/api/s2s/history?playerExternalId=u_8431&limit=50

Query	Required	Notes
playerExternalId	✅	Whose history to return.
types	—	Comma-separated filter: purchase, open, refund, cashback. Default: all.
from / to	—	ISO 8601 UTC bounds (inclusive).
limit	—	Page size (default 50, max 200).
cursor	—	Opaque cursor from a previous page.

Response — 200

{
  "items": [
    {
      "id": "txn_01J…",
      "type": "open",
      "roundPublicId": "r_01J…",
      "amountMinor": -500,
      "payoutMinor": 320,
      "currency": "EUR",
      "status": "settled",
      "idempotencyKey": "round:r_01J…",
      "providerTxnRef": "txn_xyz",
      "occurredAt": "2026-06-03T12:00:05Z"
    },
    {
      "id": "txn_01H…",
      "type": "cashback",
      "inventoryItemId": 88,
      "amountMinor": 320,
      "currency": "EUR",
      "status": "completed",
      "occurredAt": "2026-06-03T12:05:00Z"
    }
  ],
  "cursor": { "next": "c_…", "prev": null }
}

Field	Notes
type	purchase (pre-pay), open (atomic or held→open), refund, cashback.
amountMinor	Signed from the player’s perspective — negative = debited, positive = credited.
payoutMinor	Present on open rows that won.
roundPublicId / inventoryItemId	Links to the underlying resource.
idempotencyKey / providerTxnRef	The keys you can reconcile against your own wallet ledger.
status	Per-row outcome (settled, held, voided, refunded, completed).

Reconciliation

idempotencyKey and providerTxnRef are the join keys between this ledger and your wallet’s ledger. Every money movement here corresponds to exactly one wallet RPC call with the same idempotencyKey. Pull history on a schedule and reconcile against your own records to catch any divergence.

LootBox Solutions holds no balance — this is an event ledger of what was instructed, not an account statement. Your wallet remains the source of truth for the actual balance.