Skip to main content
GET
/
v1
/
partner
/
card
/
users
/
{serviceId}
/
cards
curl "https://services-staging.getplu.com/api/v1/partner/card/users/acme-user-abc123def456ghi/cards?skip=0&limit=20" \
  -H "Authorization: Bearer sk_staging_your_api_key"

{
  "status": "success",
  "message": "success",
  "data": {
    "cards": [
      {
        "serviceCardId": "acme-card-xyz789jkl012mno",
        "serviceId": "acme-user-abc123def456ghi",
        "cardName": "Jane Doe",
        "last4": "9012",
        "status": "active",
        "availableBalance": 50,
        "ledgerBalance": 50,
        "cardProgram": "custodial",
        "fundingType": "float",
        "createdAt": "2025-01-15T10:30:00.000Z"
      },
      {
        "serviceCardId": "acme-card-def456ghi789jkl",
        "serviceId": "acme-user-abc123def456ghi",
        "cardName": "Jane Doe (Travel)",
        "last4": "5678",
        "status": "frozen",
        "availableBalance": 25,
        "ledgerBalance": 25,
        "cardProgram": "custodial",
        "fundingType": "float",
        "createdAt": "2025-01-14T09:00:00.000Z"
      }
    ],
    "pagination": {
      "skip": 0,
      "limit": 20,
      "total": 2
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.getplu.com/llms.txt

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

Returns a paginated list of cards for a specific user. Only cards belonging to the specified user under your partner account are returned.
​
Authorization
string
required
Bearer token. Example: Bearer sk_staging_your_api_key
​
serviceId
string
required
The user’s service ID.
​
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.getplu.com/api/v1/partner/card/users/acme-user-abc123def456ghi/cards?skip=0&limit=20" \
  -H "Authorization: Bearer sk_staging_your_api_key"

{
  "status": "success",
  "message": "success",
  "data": {
    "cards": [
      {
        "serviceCardId": "acme-card-xyz789jkl012mno",
        "serviceId": "acme-user-abc123def456ghi",
        "cardName": "Jane Doe",
        "last4": "9012",
        "status": "active",
        "availableBalance": 50,
        "ledgerBalance": 50,
        "cardProgram": "custodial",
        "fundingType": "float",
        "createdAt": "2025-01-15T10:30:00.000Z"
      },
      {
        "serviceCardId": "acme-card-def456ghi789jkl",
        "serviceId": "acme-user-abc123def456ghi",
        "cardName": "Jane Doe (Travel)",
        "last4": "5678",
        "status": "frozen",
        "availableBalance": 25,
        "ledgerBalance": 25,
        "cardProgram": "custodial",
        "fundingType": "float",
        "createdAt": "2025-01-14T09:00:00.000Z"
      }
    ],
    "pagination": {
      "skip": 0,
      "limit": 20,
      "total": 2
    }
  }
}
This endpoint returns the same card summary data as List Cards, but filtered to a single user. Use Get Card to retrieve full card details including card number and CVV.