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

# List Virtual Cards

> Retrieve all virtual cards issued under your merchant account

Retrieve all virtual cards provisioned by your merchant organization. Supports filtering by lifecycle status and keyword search across cardholder names, references, and card PANs.

### Headers

| Header | Type | Description |
| :- | :- | :- |
| `Authorization` | `string` | `Bearer <accessToken>` |

***

### Query Parameters

| Parameter | Type | Required | Description |
| :- | :- | :- | :- |
| `status` | `string` | No | Filter by card status (`ACTIVE`, `FROZEN`, or `ALL`). |
| `search` | `string` | No | Search string matching cardholder name, reference, or last 4 digits. |
| `limit` | `number` | No | Maximum number of records to return (default `50`). |

***

### Request Example

```bash cURL theme={null}
curl -X GET "https://api.laikipay.com/v1/merchant/cards?status=ACTIVE&limit=20" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
```

***

### Response (`200 OK`)

```json theme={null}
{
  "status": "success",
  "data": [
    {
      "id": "crd_8f921ab0c1",
      "cardType": "VIRTUAL",
      "cardBrand": "VISA",
      "maskedPan": "411111******1111",
      "nameOnCard": "Alex Morgan",
      "balanceAmount": 250.0,
      "currency": "USD",
      "status": "ACTIVE",
      "createdStatus": "COMPLETED",
      "reference": "CRD_ORD_001",
      "billingAddress": {
        "street": "100 Financial District Blvd",
        "city": "New York",
        "state": "NY",
        "postalCode": "10005",
        "country": "US"
      },
      "colorTheme": "Midnight Black",
      "createdAt": "2026-10-12T07:05:00.000Z",
      "updatedAt": "2026-10-12T07:15:00.000Z"
    }
  ],
  "timestamp": "2026-10-12T07:25:00.000Z",
  "path": "/api/v1/merchant/cards"
}
```


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