---
title: "Get a Card"
method: GET
path: "/pms/api/external/request/virtual-cards/{card_id}/"
tags: ["Issuing"]
---

# Get a Card

`GET /pms/api/external/request/virtual-cards/{card_id}/`

Retrieve one card by PayVessel card ID. When status is ACTIVE or FROZEN, returns full card credentials (card_number, cvv, expiry). Poll after create until ACTIVE.

## Path parameters

- `card_id` string, uuid, required

## Headers

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

## Response `200`

Card retrieved

- VirtualCardResponse
  - `status` boolean, required — Indicates whether the request succeeded
  - `message` string, required — Human-readable result message
  - `data` IssuedCard, required
    - `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)