# Query Partner Balance

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

`POST` `/issuing/partner/query-balance`

### **Request Body**

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

&#x20;Biz\_data :

| Name                                          | Type   | Description            |
| --------------------------------------------- | ------ | ---------------------- |
| partner\_id<mark style="color:red;">\*</mark> | string | Partner ID             |
| account\_num                                  | string | Partner Account Number |

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

```
{
    "app_id": "00000000000000000",
    "partner_id": "00000000000000000",
    "request_id": "31ECEB89-Fb3C-5DAd-DeCF-bd62A3CF",
    "timestamp": "2025-04-07 13:56:59",
    "format": "JSON",
    "version": "2.0",
    "sign_type": "RSA",
    "biz_data": {
        "partner_id": "00000000000000000"
    },
    "random_key": "<generated_key>"
}
// The biz_data in this example needs to be encrypted!
```

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

| Name               | Type   | Description                                        |
| ------------------ | ------ | -------------------------------------------------- |
| account\_name      | string | Account name                                       |
| account\_num       | string | Account number                                     |
| currency           | string | Account currency, as a 3-letter ISO currency code. |
| balance            | string | total balance                                      |
| available\_balance | string | available balance                                  |
| block\_amount      | string | block amount                                       |

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

```
{
    "code": "10000",
    "msg": "Success",
    "total": 15,
    "random_key": "<random key used for decryption>",
    "sign_type": "RSA",
    "app_id": "00000000000000000",
    "data": [{
        "account_num": "10419000000401",
        "account_name": "Test A",
        "currency": "USD",
        "balance": "1008.29",
        "available_balance": "1008.29",
        "block_amount": "0.00"
    }, {
        "account_num": "10419000000401",
        "account_name": "Test A",
        "currency": "HKD",
        "balance": "100.00",
        "available_balance": "100.00",
        "block_amount": "0.00"
    }]
}
// 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 %}