---
title: "Get all Cards"
method: GET
path: "/pms/api/external/request/virtual-cards/"
tags: ["Issuing"]
---

# Get all Cards

`GET /pms/api/external/request/virtual-cards/`

List issued virtual cards for the authenticated business (customer and business cards). Returns masked_pan only — use Get a Card for full card_number and cvv on a single card.

## Query parameters

- `status` 'PENDING' | 'ACTIVE' | 'FROZEN' | 'TERMINATED' | 'FAILED'

## Headers

- `api-key` string, required
- `api-secret` string, required

## Response `200`

Virtual cards retrieved successfully

- VirtualCardListResponse
  - `status` boolean — Indicates whether the request succeeded
  - `message` string — Human-readable result message
  - `data` IssuedCard[] — List of issued cards
    - `id` string, uuid — PayVessel card ID
    - `business_id` string, uuid — Owning business
    - `kind` string — customer card
    - `customer_id` string, uuid — Linked customer ID
    - `customer_name` string — Customer display name
    - `card_name` string — Name on card
    - `masked_pan` string — Masked PAN (empty while PENDING)
    - `status` 'PENDING' | 'ACTIVE' | 'FROZEN' | 'TERMINATED' | 'FAILED' — Card lifecycle status
    - `currency` string — USD
    - `brand` string — VISA or MASTERCARD
    - `balance` string — Issuer-synced balance in USD
    - `expiry` string — Card expiry (MM/YY)
    - `card_number` string — Full PAN (GET card only, when ACTIVE/FROZEN)
    - `cvv` string — CVV (GET card only, when ACTIVE/FROZEN)
    - `created_datetime` string, date-time
    - `updated_datetime` string, date-time

## Other responses

- `401` — Unauthorized request
- `403` — Forbidden request
- `404` — Resource not found
- `500` — Internal server error

---

[API](https://skmtc.net/payvessel/apis/payvessel-value-added-services-api.md) · [All operations](https://skmtc.net/payvessel/apis/payvessel-value-added-services-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/payvessel/payvessel-value-added-services-api/versions/31040a9358ef/schema)