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

# Query Team Member Budget List

## Request Headers

<ParamField header="Content-Type" type="string" required={true}>
  Enum: `application/json`
</ParamField>

<ParamField header="Authorization" type="string" required={true}>
  Bearer authentication format, for example: Bearer \{\{API Key}}.
</ParamField>

## Response Parameters

<ResponseField name="member_count" type="int64" required={true}>
  Total number of team members.
</ResponseField>

<ResponseField name="budget_count" type="int64" required={true}>
  Number of members with a budget configured.
</ResponseField>

<ResponseField name="budgets" type="object[]" required={true}>
  List of team member budget entries.

  <Expandable title="properties" defaultOpen={true}>
    <ResponseField name="email" type="string" required={true}>
      Member email address.
    </ResponseField>

    <ResponseField name="role" type="string" required={true}>
      Member role within the team.
    </ResponseField>

    <ResponseField name="status" type="string" required={true}>
      Member account status.
    </ResponseField>

    <ResponseField name="member_id" type="string" required={true}>
      Sub-user account ID of the member.
    </ResponseField>

    <ResponseField name="phone" type="string" required={true}>
      Member phone number.
    </ResponseField>

    <ResponseField name="user_id" type="string" required={true}>
      User account ID.
    </ResponseField>

    <ResponseField name="remark_name" type="string" required={true}>
      Remark or alias name for the member.
    </ResponseField>

    <ResponseField name="budget_type" type="string" required={true}>
      Budget type. Possible values: `Unlimited`, `One-time`, `Recurring`.
    </ResponseField>

    <ResponseField name="budget_limit" type="int64" required={true}>
      Budget limit in units of 1/10000 USD (e.g., `10000` = \$1.00). Only meaningful when `budget_type` is `One-time` or `Recurring`.
    </ResponseField>

    <ResponseField name="used" type="int64" required={true}>
      Amount used in units of 1/10000 USD (e.g., `10000` = \$1.00).
    </ResponseField>

    <ResponseField name="remaining" type="int64" required={true}>
      Remaining budget in units of 1/10000 USD (e.g., `10000` = \$1.00). May be negative when usage exceeds the limit.
    </ResponseField>

    <ResponseField name="cycle" type="string" required={false}>
      Billing cycle for budget reset. Currently only `Monthly` is supported. Present only when `budget_type` is `Recurring`.
    </ResponseField>

    <ResponseField name="period_start" type="string" required={false}>
      Start time of the current billing period, formatted as an ISO 8601 string. Present only when `budget_type` is `Recurring`.
    </ResponseField>

    <ResponseField name="period_end" type="string" required={false}>
      End time of the current billing period, formatted as an ISO 8601 string. Present only when `budget_type` is `Recurring`.
    </ResponseField>
  </Expandable>
</ResponseField>

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

<ResponseExample>
  ```json 200 theme={"system"}
  {
    "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>