Skip to main content
GET
/
partner
/
wallets
/
transactions
List wallet transactions
curl --request GET \
  --url https://api.stabyl.com/v1/partner/wallets/transactions \
  --header 'X-Api-Key: <api-key>'
{
  "data": {
    "items": [
      {
        "amount": "100.00",
        "created_at": "2026-05-24T12:00:00Z",
        "currency": "USD",
        "description": "USDT deposit",
        "id": "0197f1f0-0000-7000-8000-000000000003",
        "rail": "crypto",
        "reference": "tx_001",
        "settlement_rail": "USDT",
        "status": "success",
        "tx_type": "deposit"
      }
    ],
    "next_cursor": null
  },
  "status": "success"
}

Documentation Index

Fetch the complete documentation index at: https://stabyl.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Use wallet transactions as the reconciliation source of truth. Withdrawals initiated from Stabyl Pro can appear in this timeline.

Authorizations

​
X-Api-Key
string
header
default:sb_test_your_key
required

API key. Send it in the X-Api-Key header.

Query Parameters

​
cursor
string | null

Opaque cursor from the previous wallet transaction response.

​
limit
integer<int32> | null

Number of transactions to return. Defaults to 20 and is capped by the API.

Required range: x >= 0
​
rail
null | enum<string>

Filter wallet activity by rail, such as fiat or crypto. Stablecoin rail and enabled chain routes for USD settlement.

Available options:
fiat,
crypto
​
currency
string | null

Filter wallet activity by wallet currency, such as NGN or USD.

​
status
string | null

Filter wallet activity by status, such as pending, processing, success, failed, cancelled, or hold.

​
tx_type
string | null

Filter by transaction type: deposit, withdrawal, refund, fee, or adjustment.

​
date_from
string | null

Inclusive lower time bound. Accepts RFC3339 or date-only YYYY-MM-DD; date-only values start at midnight UTC.

​
date_to
string | null

Inclusive upper time bound. Accepts RFC3339 or date-only YYYY-MM-DD; date-only values include the full UTC day.

​
reference
string | null

Case-insensitive partial match against the transaction reference.

Response

Wallet transactions

​
data
object
required

Cursor-paginated wallet transaction timeline.

​
status
enum<string>
required
Available options:
success