**版本：202601**

# 查询用量收费列表

**GET** `/openapi/2026-01/recurring_application_charges/:charge_id/usage_charge`

分页返回用量收费列表。

## 请求

**Path参数**

- `charge_id` string (required)

  收费 ID

**Query参数**

- `cursor` string

  分页游标
- `per_page` int32

  每页记录数

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `usage_charges` object[]

    用量收费列表

    *   Array \[

    - `id` string

      用量收费 ID
    - `price` string

      用量收费金额
    - `description` string

      用量收费描述
    - `balance_used` string

      已使用余额
    - `balance_remaining` string

      剩余余额
    - `created_at` string

      创建时间，ISO-8601 格式
    *   \]
  - `cursor` string

    分页游标
  - `has_more` boolean

    是否有更多记录

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "usage_charges": [
      {
        "id": "string",
        "price": "string",
        "description": "string",
        "balance_used": "string",
        "balance_remaining": "string",
        "created_at": "string"
      }
    ],
    "cursor": "string",
    "has_more": true
  }
}
```