> For the complete documentation index, see [llms.txt](https://padiwise.gitbook.io/padiwise/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://padiwise.gitbook.io/padiwise/virtual-cards/get-card-details.md).

# Get Card Details

Returns detailed information for a specific virtual card using its unique `cardId`. Data includes the full masked card number, CVV, expiry, current balance, currency, and card status (e.g., active, blocked). This is useful for viewing card details before a transaction or for internal monitoring.

{% hint style="warning" %}
**Before you begin!**

Sensitive fields like card number and CVV are returned securely for one-time use. Never cache or store these details on the client.
{% endhint %}

&#x20;<mark style="color:green;">`POST`</mark>  `{{ BASE }}/get-card/{cardid}`&#x20;

```
--header 'Accept: application/json'
--header 'Authorization: Bearer {{  access_token }}'
```

Below are the request body parameters :tada:

**Request Body**

| Name   | Type   | Description                                       |
| ------ | ------ | ------------------------------------------------- |
| cardid | String | The unique ID of the virtual card (from Padiwise) |
|        |        |                                                   |

Response Body

```
{
  "success": true,
  "message": "Card details successfully fetched.",
  "status_code": 200,
    "data": {
      "type": "virtual",
      "brand": "visa",
      "number": "1234 56•• •••• 7890",
      "expiryMonth": "12",
      "expiryYear": "2028",
      "cvv": "•••",
      "status": "active",
      "balance": 42.55,
      "billingAddress": {
        "line1": "123 Main Street",
        "city": "Lagos",
        "state": "LA",
        "postalCode": "100001",
        "country": "NG"
      }
  }
}

```