> ## 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 cards

> List virtual cards for your partner account, including card number and security code.

Returns cards for the authenticated partner, newest first. Each card includes `card_number` and `security_code`. See the [card object](https://docs.xwift.africa/guides/cards.md#card-object).

**page** `integer`

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

**limit** `integer`

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

**data.cards** `array`

[Card objects](https://docs.xwift.africa/guides/cards.md#card-object), including `card_number` and `security_code`.

**data.page** `integer`

Page that was returned.

**data.limit** `integer`

Page size that was applied.

**data.total** `integer`

Total cards for this partner.

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

```json theme={null}
{
  "code": 200,
  "message": "All cards.",
  "data": {
    "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": null,
        "last_used_on": null,
        "created_at": "2026-11-07T08:00:00+00:00",
        "updated_at": "2026-11-07T08:00:00+00:00",
        "card_number": "4242424242424242",
        "security_code": "123"
      }
    ],
    "page": 1,
    "limit": 20,
    "total": 1
  }
}
```


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