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

# Card Details

Retrieves detailed information about a specific card.

**Endpoint:** `GET /{san}/details`

**Path Parameters:**

* `san` - Secure Account Number (card identifier)

**Response:**

```json
{
  "created": "2025-07-03T09:21:55.605Z",
  "currency": "USD",
  "cvv": "054",
  "san": "21ce69Y8792043020317",
  "initialBalance": 5.0,
  "product": "S00E0000039",
  "status": "active",
  "balance": 6.95,
  "cardNumber": "5360181101056090",
  "expYear": 2027,
  "expMonth": 2,
  "cardSystem": "MC",
  "cardName": "My virtual card",
  "docid": 702727662
}
```

**Response Parameters:**

<table><thead><tr><th width="178.5555419921875">Field</th><th width="236.7777099609375">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>created</code></td><td>String (ISO 8601)</td><td>Card creation timestamp in UTC</td></tr><tr><td><code>blocked</code></td><td>String (ISO 8601) or null</td><td>Card blocked timestamp in UTC, or null </td></tr><tr><td><code>san</code></td><td>String</td><td>Secure Account Number (card identifier)</td></tr><tr><td><code>productCode</code></td><td>String</td><td>Unique identifier for the card product</td></tr><tr><td><code>cardSystem</code></td><td>String</td><td>VISA, MC</td></tr><tr><td><code>expYear</code></td><td>Number</td><td>Card expiration year</td></tr><tr><td><code>expMonth</code></td><td>Number</td><td>Card expiration month (1-12)</td></tr><tr><td><code>cvv</code></td><td>String</td><td>Card verification value</td></tr><tr><td><code>currency</code></td><td>String</td><td>Card currency code (USD, EUR, etc.)</td></tr><tr><td><code>cardNumber</code></td><td>String(null for blocked)</td><td>Full card number (when available)</td></tr><tr><td><code>initialBalance</code></td><td>Decimal</td><td>Initial balance loaded on the card</td></tr><tr><td><code>balance</code></td><td>Decimal(null for blocked)</td><td>Current card balance</td></tr><tr><td><code>status</code></td><td>String</td><td>Card status (active, blocking, blocked, frozen, expired, unknown)</td></tr><tr><td><code>cardName</code></td><td>String</td><td>User-defined card name</td></tr><tr><td><code>docid</code></td><td>Number</td><td>Document ID associated with the card</td></tr></tbody></table>
