Skip to main content
GET
https://services-staging.bitmama.io/api
/
v1
/
partner
/
card
curl "https://services-staging.bitmama.io/api/v1/partner/card?skip=0&limit=20" \
  -H "Authorization: Bearer sk_staging_your_api_key"

{
  "status": "success",
  "message": "Cards retrieved",
  "data": {
    "cards": [
      {
        "serviceCardId": "acme-rain-card-xyz789jkl012mno",
        "serviceId": "acme-rain-user-abc123def456ghi",
        "cardName": "Jane Doe",
        "last4": "9012",
        "status": "active",
        "availableBalance": 50,
        "ledgerBalance": 50,
        "cardProgram": "custodial",
        "createdAt": "2025-01-15T10:30:00.000Z"
      },
      {
        "serviceCardId": "acme-rain-card-def456ghi789jkl",
        "serviceId": "acme-rain-user-mno345pqr678stu",
        "cardName": "John Smith",
        "last4": "5678",
        "status": "frozen",
        "availableBalance": 25,
        "ledgerBalance": 25,
        "cardProgram": "custodial",
        "createdAt": "2025-01-14T09:00:00.000Z"
      }
    ],
    "pagination": {
      "skip": 0,
      "limit": 20,
      "total": 2
    }
  }
}
Returns a paginated list of all cards. Only cards belonging to your partner account are returned.
​
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/card?skip=0&limit=20" \
  -H "Authorization: Bearer sk_staging_your_api_key"

{
  "status": "success",
  "message": "Cards retrieved",
  "data": {
    "cards": [
      {
        "serviceCardId": "acme-rain-card-xyz789jkl012mno",
        "serviceId": "acme-rain-user-abc123def456ghi",
        "cardName": "Jane Doe",
        "last4": "9012",
        "status": "active",
        "availableBalance": 50,
        "ledgerBalance": 50,
        "cardProgram": "custodial",
        "createdAt": "2025-01-15T10:30:00.000Z"
      },
      {
        "serviceCardId": "acme-rain-card-def456ghi789jkl",
        "serviceId": "acme-rain-user-mno345pqr678stu",
        "cardName": "John Smith",
        "last4": "5678",
        "status": "frozen",
        "availableBalance": 25,
        "ledgerBalance": 25,
        "cardProgram": "custodial",
        "createdAt": "2025-01-14T09:00:00.000Z"
      }
    ],
    "pagination": {
      "skip": 0,
      "limit": 20,
      "total": 2
    }
  }
}
The list endpoint returns summary data (last 4 digits only, no CVV/full card number). Use Get Card to retrieve full card details for a specific card.