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

# Card object

> Fields returned for a card in API responses and webhooks.

The card object is returned by [Get card](/api-reference/cards/get-card) and [List cards](/api-reference/cards/list-cards), and is the `data` payload of `CreateCard`, `DeleteCard`, `FrozenCard`, `UnfrozenCard`, `CardStateChange` and `LockCard` [webhooks](/guides/webhooks).

## Fields

| Field | Type | Description |
| - | - | - |
| `id` | string | Card ID |
| `trade_id` | string | Transaction ID returned when the card was created |
| `currency` | string | Card currency |
| `label` | string | Card label |
| `create_time` | string | Created at |
| `card_bin` | string | BIN |
| `card_no` | string | Card number, masked |
| `cvv` | string | CVV, masked |
| `expire_date` | string | Expiry date, masked |
| `holder_username` | string | Cardholder name |
| `holder_address` | object | Cardholder billing address |
| `holder_email` | string | Cardholder email |
| `holder_phone_code` | string | Cardholder phone country code |
| `available` | number | Available balance |
| `pending` | number | Pending balance |
| `frozen` | number | Frozen balance |
| `fee` | string | Top-up fee rate in percent, for example `3.8` means 3.8% |
| `status` | string | `-1` locked, `0` active, `1` frozen, `2` closed, `3` closing |
| `physical` | string | Whether it is a physical card |
| `physical_status` | string | Physical card activation: `0` awaiting verification, `1` awaiting activation, `2` activated |
| `deliver_status` | string | Physical card shipping: `0` not requested, `1` awaiting shipping request, `2` in production, `3` shipped |
| `consumption_scene_type` | integer | Spending scenes: `0` unrestricted, `1` allowlist, `2` blocklist |
| `consumption_scene_config` | object | Spending scene settings |

Use [Get card secrets](/api-reference/cards/get-card-secrets) to get the full card number and CVV. See [Card data encryption](/guides/card-data-encryption).

## Example

```json theme={null}
{
  "id": "1f067bb2-ab76-65b2-8eed-0242ac110002",
  "type": "CreateCard",
  "data": {
    "id": "CA2507221133106",
    "trade_id": "1f066ab7-f87e-6e60-a935-0242ac110002",
    "currency": "USD",
    "create_time": "2025-07-23 19:49:59",
    "card_bin": "559292",
    "card_no": "559292******1086",
    "cvv": "***",
    "expire_date": "**/****",
    "holder_username": "VMTZ YYTTEJ",
    "holder_address": {
      "city": "Glendale",
      "state": "AZ",
      "country": "US",
      "postalCode": "85301",
      "addressLine1": "5631 West Colter Street",
      "addressLine2": ""
    },
    "available": 1.33,
    "pending": 0,
    "frozen": 0,
    "fee": "3",
    "status": 0,
    "consumption_scene_type": 0,
    "consumption_scene_config": null
  },
  "status": "Pending"
}
```