> ## Documentation Index
> Fetch the complete documentation index at: https://ppio.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 查询包月账单列表

## 请求头

<ParamField header="Authorization" type="string" required={true}>
  Bearer 身份验证格式，例如：Bearer \{\{API 密钥}}。
</ParamField>

## 查询参数

<ParamField query="category" type="string" required={false}>
  产品类型。常用值：

  * `summary`：总账单。
  * `gpu`：GPU 实例。
  * `serverless`：Serverless Endpoint。
  * `cloud_storage`：云存储。
  * `local_storage`：本地存储。
  * `image`：镜像。
  * `bare_metal`：裸金属。
</ParamField>

<ParamField query="productName" type="string" required={false}>
  产品名称，支持模糊匹配。
</ParamField>

<ParamField query="startTime" type="int64" required={false}>
  查询开始时间，秒级 Unix 时间戳。
</ParamField>

<ParamField query="endTime" type="int64" required={false}>
  查询结束时间，秒级 Unix 时间戳。
</ParamField>

<ParamField query="ownerId" type="string" required={false}>
  资源实例 ID。
</ParamField>

<Info>
  当前接口不分页，建议单次查询时间范围不超过 31 天。如需拉取更长时间，建议按自然月或自然周分段请求。
</Info>

## 响应参数

<ResponseField name="bills" type="object[]" required={true}>
  月度账单列表。

  <Expandable title="properties" defaultOpen={true}>
    <ResponseField name="userId" type="string" required={true}>
      用户账号 ID。
    </ResponseField>

    <ResponseField name="memberId" type="string" required={false}>
      子用户账号 ID。
    </ResponseField>

    <ResponseField name="startTime" type="string" required={true}>
      账单开始时间，秒级 Unix 时间戳。
    </ResponseField>

    <ResponseField name="endTime" type="string" required={true}>
      账单结束时间，秒级 Unix 时间戳。
    </ResponseField>

    <ResponseField name="productName" type="string" required={true}>
      产品名称。
    </ResponseField>

    <ResponseField name="productCategory" type="string" required={true}>
      产品类型。
    </ResponseField>

    <ResponseField name="productId" type="string" required={true}>
      产品 ID。
    </ResponseField>

    <ResponseField name="ownerID" type="string" required={true}>
      资源实例 ID。
    </ResponseField>

    <ResponseField name="tradeMode" type="string" required={true}>
      计费方式。`monthly` 表示包年包月。
    </ResponseField>

    <ResponseField name="tradeType" type="string" required={true}>
      包年包月交易类型。常用值：

      * `monthly_new_buy`：新购。
      * `monthly_re_buy`：续费。
      * `monthly_re_config`：变更配置或扩容。
    </ResponseField>

    <ResponseField name="billingMethod" type="int32" required={true}>
      计费方式：

      * `1`：按量计费。
      * `2`：包年包月。
      * `3`：退款。
      * `4`：Spot 计费。
      * `5`：Batch API。
      * `6`：Saving Plan。
      * `7`：LLM 多模态计费。
      * `8`：裸金属测试扣分。
    </ResponseField>

    <ResponseField name="basePrice" type="string" required={true}>
      单价。
    </ResponseField>

    <ResponseField name="billNum" type="string" required={true}>
      用量。`gpu` 时通常表示 GPU 卡数 × 包月时长；存储资源时通常表示存储容量。
    </ResponseField>

    <ResponseField name="amount" type="string" required={true}>
      总费用，单位为 1/10000 元。
    </ResponseField>

    <ResponseField name="voucherAmount" type="string" required={true}>
      代金券抵扣费用，单位为 1/10000 元。
    </ResponseField>

    <ResponseField name="payAmount" type="string" required={true}>
      现金支付费用，单位为 1/10000 元。
    </ResponseField>

    <ResponseField name="payAmountDisplay" type="float" required={true}>
      现金支付费用展示值，单位为元。
    </ResponseField>

    <ResponseField name="pricePrecision" type="int32" required={true}>
      价格精度。单价（元）= 单价 / 10000 / `pricePrecision`。
    </ResponseField>

    <ResponseField name="createTime" type="string" required={true}>
      账单创建时间，秒级 Unix 时间戳。
    </ResponseField>

    <ResponseField name="cycle" type="string" required={true}>
      计费周期，格式为 `YYYY-MM`。
    </ResponseField>

    <ResponseField name="storageDays" type="int32" required={false}>
      存储资源使用时长，单位为天。
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash theme={null}
  curl --request GET \
    --url 'https://api.ppio.com/openapi/v1/billing/bill/monthly/list?category=gpu&startTime=1764547200&endTime=1767225599' \
    --header 'Authorization: Bearer <API_KEY>'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "bills": [
      {
        "userId": "<string>",
        "memberId": "<string>",
        "startTime": "1764547200",
        "endTime": "1767225599",
        "productName": "<string>",
        "productCategory": "gpu",
        "ownerID": "<string>",
        "tradeMode": "monthly",
        "tradeType": "monthly_new_buy",
        "basePrice": "1000000",
        "billNum": "1",
        "amount": "1000000",
        "voucherAmount": "0",
        "payAmount": "1000000",
        "payAmountDisplay": 100,
        "pricePrecision": 1,
        "createTime": "1764547200",
        "cycle": "2025-12",
        "productId": "<string>",
        "billingMethod": 2
      }
    ]
  }
  ```
</ResponseExample>