curl -X POST "{{base_url}}/card/users" \
-H "x-api-key: YOUR_CONSUMER_KEY" \
-H "Content-Type: application/json" \
-d '{"page": 1, "limit": 20}'
{
"code": 200,
"message": "Card users.",
"data": {
"users": [
{
"user_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"email": "ada@example.com",
"name": "Ada Lovelace",
"phone": "254712345678",
"country": "KE",
"state": "Nairobi",
"city": "Nairobi",
"address": "1 Market Street",
"zip_code": "00100",
"cards": [
{
"user_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"title": "Ada Lovelace",
"color": "black",
"name": "ADA LOVELACE",
"brand": "visa",
"currency": "USD",
"balance": "25.00",
"status": "active",
"mask": "424242******4242",
"last4": "4242",
"expiration": "12/28",
"is_non_subscription": true,
"is_contactless_payment": false,
"is_physical": false,
"billing_address": {
"address": "1 Market Street",
"city": "Nairobi",
"state": "Nairobi",
"zip_code": "00100",
"country": "KE"
},
"last_used_on": null,
"created_at": "2026-11-07T08:00:00+00:00",
"updated_at": "2026-11-07T08:00:00+00:00"
}
]
}
],
"page": 1,
"limit": 20,
"total": 1
}
}
Cards
List card users
List cardholders for your partner account, with their cards.
POST
/
card
/
users
curl -X POST "{{base_url}}/card/users" \
-H "x-api-key: YOUR_CONSUMER_KEY" \
-H "Content-Type: application/json" \
-d '{"page": 1, "limit": 20}'
{
"code": 200,
"message": "Card users.",
"data": {
"users": [
{
"user_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"email": "ada@example.com",
"name": "Ada Lovelace",
"phone": "254712345678",
"country": "KE",
"state": "Nairobi",
"city": "Nairobi",
"address": "1 Market Street",
"zip_code": "00100",
"cards": [
{
"user_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"title": "Ada Lovelace",
"color": "black",
"name": "ADA LOVELACE",
"brand": "visa",
"currency": "USD",
"balance": "25.00",
"status": "active",
"mask": "424242******4242",
"last4": "4242",
"expiration": "12/28",
"is_non_subscription": true,
"is_contactless_payment": false,
"is_physical": false,
"billing_address": {
"address": "1 Market Street",
"city": "Nairobi",
"state": "Nairobi",
"zip_code": "00100",
"country": "KE"
},
"last_used_on": null,
"created_at": "2026-11-07T08:00:00+00:00",
"updated_at": "2026-11-07T08:00:00+00:00"
}
]
}
],
"page": 1,
"limit": 20,
"total": 1
}
}
Returns cardholders for the authenticated partner, newest first. Nested cards omit
card_number and security_code. ID type and ID number are not included.
Cardholders. Each item has
user_id, email, name, phone, country, state, city, address, zip_code, and cards.curl -X POST "{{base_url}}/card/users" \
-H "x-api-key: YOUR_CONSUMER_KEY" \
-H "Content-Type: application/json" \
-d '{"page": 1, "limit": 20}'
{
"code": 200,
"message": "Card users.",
"data": {
"users": [
{
"user_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"email": "ada@example.com",
"name": "Ada Lovelace",
"phone": "254712345678",
"country": "KE",
"state": "Nairobi",
"city": "Nairobi",
"address": "1 Market Street",
"zip_code": "00100",
"cards": [
{
"user_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"title": "Ada Lovelace",
"color": "black",
"name": "ADA LOVELACE",
"brand": "visa",
"currency": "USD",
"balance": "25.00",
"status": "active",
"mask": "424242******4242",
"last4": "4242",
"expiration": "12/28",
"is_non_subscription": true,
"is_contactless_payment": false,
"is_physical": false,
"billing_address": {
"address": "1 Market Street",
"city": "Nairobi",
"state": "Nairobi",
"zip_code": "00100",
"country": "KE"
},
"last_used_on": null,
"created_at": "2026-11-07T08:00:00+00:00",
"updated_at": "2026-11-07T08:00:00+00:00"
}
]
}
],
"page": 1,
"limit": 20,
"total": 1
}
}
