Skip to main content
GET
/
api
/
v1
/
widget
/
users
/
{user_id}
/
transactions
curl "https://api.zebedee.io/api/v1/widget/users/4ac4fd8a-cc2c-4d03-af09-a76f4e89d652/transactions?skip=0&limit=20" \
  -H "apikey: YOUR_API_KEY"
{
  "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 "https://api.zebedee.io/api/v1/widget/users/4ac4fd8a-cc2c-4d03-af09-a76f4e89d652/transactions?skip=0&limit=20" \
  -H "apikey: YOUR_API_KEY"
{
  "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
}