Skip to main content
GET
https://services-staging.bitmama.io/api
/
v1
/
partner
/
wallet
/
transactions
curl "https://services-staging.bitmama.io/api/v1/partner/wallet/transactions?skip=0&limit=20" \
  -H "Authorization: Bearer sk_staging_your_api_key"
{
  "status": "success",
  "message": "Wallet transactions retrieved",
  "data": {
    "transactions": [
      {
        "_id": "507f1f77bcf86cd799439011",
        "partnerId": "acme-partner-abc123",
        "amount": 1.5,
        "currency": "USD",
        "type": "debit",
        "status": "success",
        "action": "card-creation-fee",
        "narration": "Card creation fee for user acme-rain-user-abc123",
        "serviceCardId": "acme-rain-card-xyz789jkl012mno",
        "createdAt": "2025-01-15T10:30:00.000Z"
      },
      {
        "_id": "507f1f77bcf86cd799439012",
        "partnerId": "acme-partner-abc123",
        "amount": 100,
        "currency": "USD",
        "type": "debit",
        "status": "success",
        "action": "funding",
        "narration": "Card funding for acme-rain-card-xyz789jkl012mno",
        "serviceCardId": "acme-rain-card-xyz789jkl012mno",
        "createdAt": "2025-01-15T11:00:00.000Z"
      }
    ],
    "total": 42,
    "skip": 0,
    "limit": 20
  }
}
Returns a paginated list of wallet transactions — credits and debits for KYC fees, card funding, withdrawals, and other operations.
Authorization
string
required
Bearer token. Example: Bearer sk_staging_your_api_key
skip
integer
default:"0"
Number of records to skip for pagination.
limit
integer
default:"50"
Maximum number of records to return.
curl "https://services-staging.bitmama.io/api/v1/partner/wallet/transactions?skip=0&limit=20" \
  -H "Authorization: Bearer sk_staging_your_api_key"
{
  "status": "success",
  "message": "Wallet transactions retrieved",
  "data": {
    "transactions": [
      {
        "_id": "507f1f77bcf86cd799439011",
        "partnerId": "acme-partner-abc123",
        "amount": 1.5,
        "currency": "USD",
        "type": "debit",
        "status": "success",
        "action": "card-creation-fee",
        "narration": "Card creation fee for user acme-rain-user-abc123",
        "serviceCardId": "acme-rain-card-xyz789jkl012mno",
        "createdAt": "2025-01-15T10:30:00.000Z"
      },
      {
        "_id": "507f1f77bcf86cd799439012",
        "partnerId": "acme-partner-abc123",
        "amount": 100,
        "currency": "USD",
        "type": "debit",
        "status": "success",
        "action": "funding",
        "narration": "Card funding for acme-rain-card-xyz789jkl012mno",
        "serviceCardId": "acme-rain-card-xyz789jkl012mno",
        "createdAt": "2025-01-15T11:00:00.000Z"
      }
    ],
    "total": 42,
    "skip": 0,
    "limit": 20
  }
}

Transaction Actions

ActionDescription
fundingCard funding debit
withdrawalCard withdrawal credit
card-creation-feeFee charged for card creation
kyc-feeFee charged for user KYC verification