# Balance of Card

This API is used to find the balance of an activated card.

* **Path: /api/v1/card/balance**
* **Method: POST**
* **Content-Type**

  application/json
* **Headers**

| Key           | Type   | Required | Comments             |
| ------------- | ------ | -------- | -------------------- |
| authorization | string | YES      | Authorization Header |

* **Body**

| Key         | Type   | Required | Comments                                                               |
| ----------- | ------ | -------- | ---------------------------------------------------------------------- |
| api\_key    | string | YES      | api key                                                                |
| request\_id | string | YES      | Unique id; the shortest is 20 characters, the longest is 64 characters |
| timestamp   | string | YES      | 13-digit; Valid for plus or minus 30 seconds                           |
| username    | string | YES      | Unique username of the account.                                        |
| kit\_number | string | YES      | Show on card                                                           |
| sign        | string | YES      | sign: MD5(api\_key+username+timestamp+secret+request\_id)lowercase hex |

* **Example**

  ```js
  {
    api_key: 'fd01a53d7834b06c080cd1024ae9c60a',
    request_id: '4aa5cc9f47cc4286afa363d108bd4036',
    timestamp: '1682074640097',
    username: 'lili111',
    kit_number: '111111',
    sign: 'd0281c80bed657ff93fb997c218c44c2'
  }
  ```

  **signature example**:MD5(fd01a53d7834b06c080cd1024ae9c60alili111168207464009716388ce4331b35e8e0d32777ba57d7d94aa5cc9f47cc4286afa363d108bd4036)
* **Response**

| Key  | Type   | Comments             |
| ---- | ------ | -------------------- |
| code | number | Response code        |
| msg  | string | Response message     |
| data | object | [details](#balance1) |

**details**

| Key     | Type   | Comments     |
| ------- | ------ | ------------ |
| balance | string | Card balance |

* **Example**

  ```js
  {
    "code": 10200,
    "msg": "ok"
    "data": {
      "balance": "10.22"
    }
  }
  ```
