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

# get_card_details

> Get decrypted PAN, CVV, expiry, and current balance for a specific card.

Connect to `https://mcp.agentcard.sh/mcp` with the **user's connection token** (or a `buy_token` for org-owned accounts).

**Behavior:** read-only, idempotent.

## What it does

Get decrypted PAN, CVV, expiry, and current balance for a specific card. Use this only when you need to fill in a payment form — prefer get\_card\_balance if you only need the balance. May require human approval before returning credentials. If approval is required, prompt the user and then call approve\_request. Card details are encrypted at rest with AES-256-GCM.

## Inputs

| Field                  | Type   | Description                                                                                                                                                                                                    |
| ---------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `card_id` *(required)* | string | The card ID                                                                                                                                                                                                    |
| `approval_id`          | string | Approval id from a prior approval\_required response, once the user has approved. Only for cards created through ANOTHER app: first call without it (the user is emailed an approve link), then retry with it. |

## Returns

| Field                  | Type   | Description                                                                                                                                                                                                                                                                                                                                                                                         |
| ---------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `message` *(required)* | string | Human-readable card details (or an approval-required prompt).                                                                                                                                                                                                                                                                                                                                       |
| `status`               | string | Outcome discriminator: "details" when credentials were returned, "approval\_required" when human approval is needed first, "not\_accessible" when the card exists outside this connection's scope, "policy\_denied" when the card's rules refuse the reveal, with the reason in the message, for example a CLI-only card read from MCP, "managed\_by\_organization" for org-issued read-only cards. |
| `cardId`               | string | The card ID.                                                                                                                                                                                                                                                                                                                                                                                        |
| `expiry`               | string | Card expiry (MM/YY). Present only when status is "details".                                                                                                                                                                                                                                                                                                                                         |
| `last4`                | string | Last four digits of the card number. Present only when status is "details".                                                                                                                                                                                                                                                                                                                         |
| `balanceCents`         | number | Card balance in cents. Present only when status is "details".                                                                                                                                                                                                                                                                                                                                       |
| `balanceDollars`       | string | Card balance formatted as USD dollars, e.g. "12.50". Present only when status is "details".                                                                                                                                                                                                                                                                                                         |
| `cardStatus`           | string | Card status, e.g. "active" or "closed". Present only when status is "details".                                                                                                                                                                                                                                                                                                                      |
| `approvalId`           | string | The approval request ID to pass to approve\_request. Present only when status is "approval\_required".                                                                                                                                                                                                                                                                                              |

## Example call

```json theme={null}
{
  "tool": "get_card_details",
  "arguments": {
    "card_id": "\u2026"
  }
}
```