Get User Transactions

Retrieve a paginated transaction history for a widget user.

GET /api/v1/widget/users/{user_id}/transactions

cURL

curl "https://api.zbdpay.com/api/v1/widget/users/4ac4fd8a-cc2c-4d03-af09-a76f4e89d652/transactions?skip=0&limit=20" \
  -H "apikey: YOUR_API_KEY"

200

{
  "userId": "4ac4fd8a-cc2c-4d03-af09-a76f4e89d652",
  "transactions": [
    {
      "id": "f4ba94c1-1234-5678-abcd-ef0123456789",
      "type": "reward",
      "status": "completed",
      "description": "Level 37 reward",
      "amount": 1000,
      "currency": "USD",
      "fee": 0,
      "counterparty": "Game Rewards",
      "createdAt": "2026-05-28T22:21:03.067Z"
    }
  ],
  "total": 1,
  "skip": 0,
  "limit": 20
}

Description

Returns a widget user’s transaction history for your project. Use this from your server when you need to show reward funding and cashout activity outside the widget.

Amounts are returned in currency minor units. For USD, 100 equals $1.00.

Configuration

Header Parameters

apikey · string · required

Your ZBD project API key (production scope).

Path Parameters

user_id · string · required

The ZBD user ID returned by Create User.

Query Parameters

skip · integer

Number of transactions to skip. Defaults to 0.

limit · integer

Maximum number of transactions to return. Defaults to 20; maximum is 100.

type · string

Optional transaction type filter.

startDate · string

Optional ISO 8601 start date filter.

endDate · string

Optional ISO 8601 end date filter.

cURL

curl "https://api.zbdpay.com/api/v1/widget/users/4ac4fd8a-cc2c-4d03-af09-a76f4e89d652/transactions?skip=0&limit=20" \
  -H "apikey: YOUR_API_KEY"

200

{
  "userId": "4ac4fd8a-cc2c-4d03-af09-a76f4e89d652",
  "transactions": [
    {
      "id": "f4ba94c1-1234-5678-abcd-ef0123456789",
      "type": "reward",
      "status": "completed",
      "description": "Level 37 reward",
      "amount": 1000,
      "currency": "USD",
      "fee": 0,
      "counterparty": "Game Rewards",
      "createdAt": "2026-05-28T22:21:03.067Z"
    }
  ],
  "total": 1,
  "skip": 0,
  "limit": 20
}