> ## 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>

## 响应参数

<ResponseField name="member_count" type="int64" required={true}>
  团队总成员数。
</ResponseField>

<ResponseField name="budget_count" type="int64" required={true}>
  已配置预算的成员数。
</ResponseField>

<ResponseField name="budgets" type="object[]" required={true}>
  成员预算列表。

  <Expandable title="properties" defaultOpen={true}>
    <ResponseField name="email" type="string" required={true}>
      成员邮箱。
    </ResponseField>

    <ResponseField name="role" type="string" required={true}>
      成员角色。
    </ResponseField>

    <ResponseField name="status" type="string" required={true}>
      成员状态。
    </ResponseField>

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

    <ResponseField name="phone" type="string" required={true}>
      手机号。
    </ResponseField>

    <ResponseField name="user_id" type="string" required={true}>
      用户账号 ID。
    </ResponseField>

    <ResponseField name="remark_name" type="string" required={true}>
      备注名。
    </ResponseField>

    <ResponseField name="budget_type" type="string" required={true}>
      预算类型。取值：`Unlimited`（无限制）、`One-time`（一次性）、`Recurring`（循环）。
    </ResponseField>

    <ResponseField name="budget_limit" type="int64" required={true}>
      预算上限，单位为 1/10000 元（即 10000 = 1 元）。
    </ResponseField>

    <ResponseField name="used" type="int64" required={true}>
      已用额度，单位为 1/10000 元（即 10000 = 1 元）。
    </ResponseField>

    <ResponseField name="remaining" type="int64" required={true}>
      剩余额度，单位为 1/10000 元（即 10000 = 1 元）。当使用量超出限额时，该值可能为负数。
    </ResponseField>

    <ResponseField name="cycle" type="string" required={false}>
      重置周期，仅在 `budget_type=Recurring` 时有值。当前仅支持 `Monthly`（按月）。
    </ResponseField>

    <ResponseField name="period_start" type="string" required={false}>
      当前周期开始时间，ISO 8601 格式时间字符串。仅在 `budget_type=Recurring` 时有值。
    </ResponseField>

    <ResponseField name="period_end" type="string" required={false}>
      当前周期结束时间，ISO 8601 格式时间字符串。仅在 `budget_type=Recurring` 时有值。
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash theme={null}
  curl --request GET \
    --url https://api.ppio.com/openapi/v1/user/team/budget-list \
    --header 'Authorization: Bearer <API_KEY>'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "member_count": 0,
    "budget_count": 0,
    "budgets": [
      {
        "email": "<string>",
        "role": "<string>",
        "status": "<string>",
        "member_id": "<string>",
        "phone": "<string>",
        "user_id": "<string>",
        "remark_name": "<string>",
        "budget_type": "<string>",
        "budget_limit": 0,
        "used": 0,
        "remaining": 0,
        "cycle": "<string>",
        "period_start": "<string>",
        "period_end": "<string>"
      }
    ]
  }
  ```
</ResponseExample>