# Query Card Balance

### **Request URI** <a href="#payin-by-creditcard" id="payin-by-creditcard"></a>

`POST` `/issuing/card/query-card-balance`

### **Request Body**

&#x20;**Refer to :** [**common**](https://docs.pagsmile.com/issuing-card-api/common)

&#x20;**Biz\_data :**

| Name                                          | Type   | Description |
| --------------------------------------------- | ------ | ----------- |
| card\_token<mark style="color:red;">\*</mark> | string | Card token  |

### **Request** Example <a href="#example" id="example"></a>

```
{
    "app_id": "00000000000000000",
    "partner_id": "00000000000000000",
    "request_id": "E97BB43e-de41-4f3D-6238-5b95184C",
    "timestamp": "2025-04-07 13:56:37",
    "format": "JSON",
    "version": "2.0",
    "sign_type": "RSA",
    "biz_data": {
        "card_token": "450620141926"
    },
    "random_key": "<generated_key>"
}
// The biz_data in this example needs to be encrypted!
```

### Response <a href="#example" id="example"></a>

<table><thead><tr><th width="230.76171875">Name</th><th width="187.19140625">Type</th><th>Description</th></tr></thead><tbody><tr><td>account_name</td><td>string</td><td>Account Name</td></tr><tr><td>account_num</td><td>string</td><td>Account number</td></tr><tr><td>currency</td><td>string</td><td>Account currency. As a 3-letter ISO currency code.</td></tr><tr><td>balance</td><td>string</td><td>Total balance.<a href="../../data/trade-currency">Unit</a></td></tr><tr><td>available_balance</td><td>string</td><td>Available balance.<a href="../../data/trade-currency">Unit</a></td></tr><tr><td>block_amount</td><td>string</td><td>Block amount.<a href="../../data/trade-currency">Unit</a></td></tr><tr><td>card_token</td><td>string</td><td>Card token</td></tr></tbody></table>

{% tabs %}
{% tab title="200:OK" %}

```
{
    "code": "10000",
    "msg": "Success",
    "total": 7,
    "random_key": "<random key used for decryption>",
    "sign_type": "RSA",
    "app_id": "00000000000000000",
    "data": [{
        "account_num": "658704******3982",
        "account_name": "Test User",
        "currency": "USD",
        "balance": "100012063.26",
        "available_balance": "100012063.26",
        "block_amount": "0.00",
        "card_token": "450620141926"
    }, {
        "account_num": "658704******3982",
        "account_name": "Test User",
        "currency": "EUR",
        "balance": "100000000.00",
        "available_balance": "100000000.00",
        "block_amount": "0.00",
        "card_token": "450620141926"
    }]
}
// The data in this example has already been decrypted.
```

{% endtab %}

{% tab title="400: invalid-signature" %}

```
{
    "code": "40002",
    "msg": "Business Failed",
    "sub_code": "invalid-signature",
    "sub_msg": "invalid signature"
}
```

{% endtab %}
{% endtabs %}