List Customer Cards

GET

/api/v1/cardissuance/customer/{customerId}

Returns a paginated list of all cards belonging to a specific customer.

📤 Response Fields

Field	Type	Description
`data[].id`	`string (uuid)`	Card identifier
`data[].productId`	`string (uuid)`	Card product
`data[].currency`	`string`	Card currency
`data[].cardType`	`string`	`virtual` or `physical`
`data[].status`	`string`	Current card status
`data[].maskedCardNumber`	`string`	Card number with the middle digits masked
`data[].createdAt`	`string (date-time)`	Creation timestamp
`pagination.total`	`integer`	Total matching cards
`pagination.limit`	`integer`	Page size used
`pagination.offset`	`integer`	Items skipped
`pagination.hasMore`	`boolean`	Whether more pages exist

Request

Path Params

Query Params

Header Params

Responses

🟢200

application/json

Customer cards retrieved.

Bodyapplication/json

🟠401

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/v1/cardissuance/customer/3fa85f64-5717-4562-b3fc-2c963f66afa6?limit=20&offset=0' \
--header 'X-API-Key;' \
--header 'X-Signature;' \
--header 'X-Timestamp;' \
--header 'X-Nonce;' \
--header 'X-Body-Hash;'

Response Example

200 - Success

{
    "data": [
        {
            "id": "6f1c9a2e-4b3d-4e7a-9c5f-1a2b3c4d5e6f",
            "customerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "fullName": "Ishaan Singh",
            "email": "ishaan.singh20406@yopmail.com",
            "productId": "b1f3c7a2-6c4e-4d91-9f2a-123456789abc",
            "currency": "USDC",
            "cardType": "virtual",
            "status": "active",
            "maskedCardNumber": "4111 11** **** 1111",
            "createdAt": "2026-01-15T10:30:00Z"
        }
    ],
    "pagination": {
        "total": 1,
        "limit": 20,
        "offset": 0,
        "hasMore": false
    }
}

Modified at 2026-08-19 09:45:46

List Cards

Get Card Details