WalletD developers
Users and balances

A user's ledger history across cash and points

The user's own ledger entries across cash and points, newest first, each with the transaction it belongs to, its direction and its commodity.

GET/v1/users/{userId}/transactions

The user's own ledger entries across cash and points, newest first, each with the transaction it belongs to, its direction and its commodity. Requires balances:read; a user token may read only itself (forbidden, 403) and an unknown id gives user_not_found (404). A staff read is recorded in the sensitive-read access log. Cursor paged: pass the last id you saw as cursor; limit is clamped to 1-100 and defaults to 50.

Authorization

bearerAuth
AuthorizationBearer <token>

A tenant API key (sk_{env}_{id}_{secret}), a wallet user token, or an IdP access token. Which principal the credential resolves to decides the scopes it carries; see the authentication guide.

In: header

Path Parameters

userId*string
Formatuuid

Query Parameters

cursor?string

Last seen id from the previous page. The listing resumes after that row, so an id that belongs to no row in the listing is refused invalid_request (400) rather than answered with an empty page.

Formatuuid
limit?integer
Range1 <= value <= 100
Default50

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://example.com/v1/users/497f6eca-6276-4993-bfeb-53cbbbba6f08/transactions"
[  {    "txn_id": "3dd6ecc9-94bf-4fc7-98ae-cdbe5b6f62e4",    "txn_type": "string",    "purpose": "string",    "direction": "debit",    "amount": 0,    "commodity": "string",    "created_at": "2019-08-24T14:15:22Z"  }]