# 查询账户余额（旧）
#### 功能介绍
客户可以查询自身的账户余额。
![](https://support.huaweicloud.com/api-oce/public_sys-resources/note_3.0-zh-cn.png)
该接口即将下线，"查询账户余额"新接口请参考[查询账户余额-ShowCustomerAccountBalances](https://support.huaweicloud.com/api-oce/mac_00001.html)。
#### Web UI
客户登录费用中心进入"[总览](https://account.huaweicloud.com/usercenter/#/userindex/allview)"页面，在"可用额度"区域可以查询自身的账户余额。
#### REST API
客户在自建平台查询自身的账户余额。
![](https://support.huaweicloud.com/api-oce/public_sys-resources/note_3.0-zh-cn.png)
客户查询自身的账户余额的时候，只允许使用客户自身的AK/SK或者Token调用。
1. URI GET /v1.0/{domain_id}/customer/account-mgr/balances
   参数说明请参见下表。
   表1URI参数说明 
   | 参数        | 是否必选 | 取值范围    | 描述                                                                                                                                                       |
   |:---|:---|:---|:---|
   | domain_id | 是    | 最大长度：64 | 客户账号ID。获取方法请参见[如何获取客户的customer_id/domain_id](https://support.huaweicloud.com/api-oce/offl_110002.html)。 此参数暂不校验。 |
      
   

2. 请求消息 请求参数
   无。
   请求示例
   ```
   GET https://bss.myhuaweicloud.com/v1.0/{domain_id}/customer/account-mgr/balances HTTP/1.1
   Content-Type: application/json
   X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ
   ```
   
3. 响应消息 响应参数
   
   | 参数               | 参数类型                   | 描述                                                                                                                                                                                                                                                                                                                                                                          |
   |:---|:---|:---|
   | error_code       | String                 | 状态码。 具体请参见[4]。                                                                                                                                                                                                                                                                              |
   | error_msg        | String                 | 错误描述信息。                                                                                                                                                                                                                                                                                                                                                                     |
   | account_balances | List\<AccountBalance\> | 账户余额列表。 具体请参见[表2]                                                                                                                                                                                                                                                                     |
   | debtAmount       | Number                 | 欠款总金额。                                                                                                                                                                                                                                                                                                                                                                      |
   | measureId        | Integer                | 度量单位： - 1：元  - 2：角  - 3：分   |
   | currency         | String                 | 币种。 CNY：人民币。                                                                                                                                                                                                                                                                                                                         |
      
    表2AccountBalance 
   | 参数                | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
   |:---|:---|:---|
   | account_id        | String  | 账户标识。                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
   | account_type      | Integer | 账户类型。 - 1：余额  - 2：信用  - 5：奖励  - 7：保证金   |
   | amount            | Double  | 余额。                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
   | currency          | String  | 币种。 CNY：人民币。 值为空代表人民币。                                                                                                                                                                                                                                                                                                                                                       |
   | designated_amount | Double  | 专款专用余额。                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
   | credit_amount     | Double  | 总信用额度，仅信用账户存在该字段。                                                                                                                                                                                                                                                                                                                                                                                                                                                |
   | measure_unit      | Integer | 度量单位。 1：元                                                                                                                                                                                                                                                                                                                                                                                                              |
   | memo              | String  | 备注。                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
   | type              | String  | - 0：华为云账户  - 1：伙伴拨款账户 仅当客户关联合作伙伴且关联类型为代售模式时，才会存在伙伴拨款账户。                                                                                                                                  |
      
   响应示例
   ```
   HTTP/1.1 200 OK
   Content-Type: application/json;charset=UTF-8
   Content-Length: length
   Date: response time  
   {
   "error_code": "CBC.0000",
   "error_msg": "success",
   "account_balances": [{
   "account_id": "AT001016B6A58D3D60",
   "account_type": 1,
   "amount": 20810.92,
   "currency": "CNY",
   "designated_amount": 14999.98,
   "credit_amount": null,
   "measure_unit": 1,
   "memo": null,
   "type": "1"
   },
   {
   "account_id": "AT001016B6A58D3D81",
   "account_type": 5,
   "amount": 0,
   "currency": "CNY",
   "designated_amount": 0,
   "credit_amount": null,
   "measure_unit": 1,
   "memo": null,
   "type": "1"
   }
   ],
   "debtAmount": 0,
   "measureId": 1,
   "currency": "CNY"
   }
   ```
   
4. 状态码
   ![](https://support.huaweicloud.com/api-oce/public_sys-resources/note_3.0-zh-cn.png)
   - 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。
   
   - 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。
    
   
   | HTTP状态码 | 错误码      | 描述    |
   |:---|:---|:---|
   | 200     | CBC.0000 | 成功。   |
   | 500     | CBC.0999 | 其他错误。 |
   | 403     | CBC.0151 | 访问拒绝。 |
   | 400     | CBC.0100 | 参数错误。 |