> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xwift.africa/llms.txt
> Use this file to discover all available pages before exploring further.

# List card users

> List cardholders for your partner account, with their cards.

Returns cardholders for the authenticated partner, newest first. Nested cards omit `card_number` and `security_code`. ID type and ID number are not included.

**page** `integer`

Page number, starting at `1`. Defaults to `1`.

**limit** `integer`

Page size. Must be at least `1`. Defaults to `20`.

**data.users** `array`

Cardholders. Each item has `user_id`, `email`, `name`, `phone`, `country`, `state`, `city`, `address`, `zip_code`, and `cards`.

**data.page** `integer`

Page that was returned.

**data.limit** `integer`

Page size that was applied.

**data.total** `integer`

Total cardholders for this partner.

```bash theme={null}
curl -X POST "{{base_url}}/card/users" \
  -H "x-api-key: YOUR_CONSUMER_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page": 1, "limit": 20}'
```

```json theme={null}
{
  "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
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.