Envelope[AccountTransactionPage]

data object

anyOf

• AccountTransactionPage
• null

items object[]required

Array [

amountAmountrequired

balanceBalancerequired

category objectrequired

anyOf

• BalanceCategory
• string

Balance transaction categories mirrored from billing-service.

Must stay a superset of TransactionCategory in billing-service src/balance/api/v1/schemas.py — a category that billing can emit but this enum lacks used to fail response serialization with an unhandled ValidationError (HTTP 500, see INCIDENT_2026_05_20 follow-up: transactions re-categorized to manual-adjustment broke GET /accounts/transactions for the affected users). AccountTransaction.category additionally falls back to a plain string for unknown values so a future billing-side category never 500s this endpoint again.

BalanceCategory

Balance transaction categories mirrored from billing-service.

Must stay a superset of TransactionCategory in billing-service src/balance/api/v1/schemas.py — a category that billing can emit but this enum lacks used to fail response serialization with an unhandled ValidationError (HTTP 500, see INCIDENT_2026_05_20 follow-up: transactions re-categorized to manual-adjustment broke GET /accounts/transactions for the affected users). AccountTransaction.category additionally falls back to a plain string for unknown values so a future billing-side category never 500s this endpoint again.

Possible values: [funding, refund, withdraw, shop, direct-top-up, steam-gifts, manual-adjustment]

createdAtstring<date-time>required

currencyCurrencyrequired

description object

anyOf

• string
• null

string

idIdrequired

orderIdOrderidrequired

orderIdRaw object

anyOf

• string
• null

string

transactionIdTransactionidrequired

]

totalCountTotalcountrequired

errorCode object

anyOf

• string
• null

string

errors object

anyOf

• object[]
• null

Array [

codeFieldErrorCoderequired

Possible values: [MISSING, OUT_OF_RANGE, INVALID_FORMAT, INVALID_VALUE, NOT_ALLOWED, TOO_LONG, TOO_SHORT]

fieldFieldrequired

messageMessagerequired

]

statusTransactionStatusrequired

Possible values: [SUCCESS, IN_PROGRESS, PARTIALLY_COMPLETED, CANCELLED]

statusCodeStatusCoderequired

Possible values: [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14]

statusMessageStatusmessagerequired

traceIdTraceidrequired

Envelope[AccountTransactionPage]

{
  "data": {
    "items": [
      {
        "amount": 0,
        "balance": 0,
        "category": "funding",
        "createdAt": "2024-07-29T15:51:28.071Z",
        "currency": "string",
        "description": "string",
        "id": "string",
        "orderId": "string",
        "orderIdRaw": "string",
        "transactionId": "string"
      }
    ],
    "totalCount": 0
  },
  "errorCode": "string",
  "errors": [
    {
      "code": "MISSING",
      "field": "string",
      "message": "string"
    }
  ],
  "status": "SUCCESS",
  "statusCode": 0,
  "statusMessage": "string",
  "traceId": "string"
}