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"
const response = await fetch(
'https://services-staging.getplu.com/api/v1/partner/card/users/acme-user-abc123def456ghi/cards?skip=0&limit=20',
{
headers: {
'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
}
}
}
{
"status": "error",
"message": "USER_NOT_FOUND",
"data": {
"error": "User not found"
}
}
Users
List User Cards
List all cards belonging to a specific user
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"
const response = await fetch(
'https://services-staging.getplu.com/api/v1/partner/card/users/acme-user-abc123def456ghi/cards?skip=0&limit=20',
{
headers: {
'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
}
}
}
{
"status": "error",
"message": "USER_NOT_FOUND",
"data": {
"error": "User not found"
}
}
Returns a paginated list of cards for a specific user. Only cards belonging to the specified user under your partner account are returned.
string
required
Bearer token. Example:
Bearer sk_staging_your_api_keystring
required
The user’s service ID.
integer
default:"0"
Number of records to skip for pagination.
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"
const response = await fetch(
'https://services-staging.getplu.com/api/v1/partner/card/users/acme-user-abc123def456ghi/cards?skip=0&limit=20',
{
headers: {
'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
}
}
}
{
"status": "error",
"message": "USER_NOT_FOUND",
"data": {
"error": "User not found"
}
}
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.
⌘I