Skip to main content
GET
https://services-staging.bitmama.io/api
/
v1
/
partner
/
card
/
transactions
curl "https://services-staging.bitmama.io/api/v1/partner/card/transactions?skip=0&limit=20" \
  -H "Authorization: Bearer sk_staging_your_api_key"
{
  "status": "success",
  "message": "Transactions retrieved",
  "data": {
    "transactions": [
      {
        "serviceTransactionId": "acme-rain-card-transactions-pqr345",
        "serviceCardId": "acme-rain-card-xyz789jkl012mno",
        "amount": 42.50,
        "currency": "USD",
        "status": "settled",
        "transactionType": "purchase",
        "description": "Online purchase",
        "merchantName": "Amazon",
        "merchantCountry": "US",
        "createdAt": "2025-01-15T14:30:00.000Z"
      },
      {
        "serviceTransactionId": "acme-rain-card-transactions-stu678",
        "serviceCardId": "acme-rain-card-xyz789jkl012mno",
        "amount": 15.00,
        "currency": "USD",
        "status": "authorized",
        "transactionType": "purchase",
        "description": "Pending transaction",
        "merchantName": "Netflix",
        "merchantCountry": "US",
        "createdAt": "2025-01-15T16:00:00.000Z"
      }
    ],
    "pagination": {
      "skip": 0,
      "limit": 20,
      "total": 2
    }
  }
}
Returns a paginated list of card transactions. Optionally filter by a specific card.
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.
serviceCardId
string
Filter transactions to a specific card.
curl "https://services-staging.bitmama.io/api/v1/partner/card/transactions?skip=0&limit=20" \
  -H "Authorization: Bearer sk_staging_your_api_key"
{
  "status": "success",
  "message": "Transactions retrieved",
  "data": {
    "transactions": [
      {
        "serviceTransactionId": "acme-rain-card-transactions-pqr345",
        "serviceCardId": "acme-rain-card-xyz789jkl012mno",
        "amount": 42.50,
        "currency": "USD",
        "status": "settled",
        "transactionType": "purchase",
        "description": "Online purchase",
        "merchantName": "Amazon",
        "merchantCountry": "US",
        "createdAt": "2025-01-15T14:30:00.000Z"
      },
      {
        "serviceTransactionId": "acme-rain-card-transactions-stu678",
        "serviceCardId": "acme-rain-card-xyz789jkl012mno",
        "amount": 15.00,
        "currency": "USD",
        "status": "authorized",
        "transactionType": "purchase",
        "description": "Pending transaction",
        "merchantName": "Netflix",
        "merchantCountry": "US",
        "createdAt": "2025-01-15T16:00:00.000Z"
      }
    ],
    "pagination": {
      "skip": 0,
      "limit": 20,
      "total": 2
    }
  }
}

Transaction Statuses

StatusDescription
authorizedTransaction approved, funds held
declinedTransaction declined
reversedTransaction reversed (refund)
settledTransaction finalized

Transaction Types

TypeDescription
purchaseCard purchase at a merchant
withdrawalATM or cash withdrawal
refundMerchant refund