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

# Query Team Member Budget List

## Request Headers

**Content-Type** `string` *required*

Enum: `application/json`

**Authorization** `string` *required*

Bearer authentication format, for example: Bearer \{\{API Key}}.

## Response Parameters

**member\_count** `int64` *required*

Total number of team members.

**budget\_count** `int64` *required*

Number of members with a budget configured.

**budgets** `object[]` *required*

List of team member budget entries.

**properties**

**email** `string` *required*

Member email address.

**role** `string` *required*

Member role within the team.

**status** `string` *required*

Member account status.

**member\_id** `string` *required*

Sub-user account ID of the member.

**phone** `string` *required*

Member phone number.

**user\_id** `string` *required*

User account ID.

**remark\_name** `string` *required*

Remark or alias name for the member.

**budget\_type** `string` *required*

Budget type. Possible values: `Unlimited`, `One-time`, `Recurring`.

**budget\_limit** `int64` *required*

Budget limit in units of 1/10000 USD (e.g., `10000` = \$1.00). Only meaningful when `budget_type` is `One-time` or `Recurring`.

**used** `int64` *required*

Amount used in units of 1/10000 USD (e.g., `10000` = \$1.00).

**remaining** `int64` *required*

Remaining budget in units of 1/10000 USD (e.g., `10000` = \$1.00). May be negative when usage exceeds the limit.

**cycle** `string`

Billing cycle for budget reset. Currently only `Monthly` is supported. Present only when `budget_type` is `Recurring`.

**period\_start** `string`

Start time of the current billing period, formatted as an ISO 8601 string. Present only when `budget_type` is `Recurring`.

**period\_end** `string`

End time of the current billing period, formatted as an ISO 8601 string. Present only when `budget_type` is `Recurring`.

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

```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>"
    }
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.