# Query Team Member Budget List - Documentation

> For the complete documentation index, see [llms.txt](/llms.txt). Markdown is available with `Accept: text/markdown` and `.md` URL variants.

Source: /docs/api-reference/budget-query-member-list

# Query Team Member Budget List

GET

/

openapi

/

v1

/

user

/

team

/

budget-list

Try it

```
curl --request GET \
--url https://api.novita.ai/openapi/v1/user/team/budget-list \
--header 'Authorization: Bearer '
```

200

```
{
"member_count": 0,
"budget_count": 0,
"budgets": [
{
"email": "",
"role": "",
"status": "",
"member_id": "",
"phone": "",
"user_id": "",
"remark_name": "",
"budget_type": "",
"budget_limit": 0,
"used": 0,
"remaining": 0,
"cycle": "",
"period_start": "",
"period_end": ""
}
]
}
```

##

[​](#request-headers)

Request Headers

[​](#param-content-type)

Content-Type

string

required

Enum: `application/json`

[​](#param-authorization)

Authorization

string

required

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

##

[​](#response-parameters)

Response Parameters

[​](#param-member-count)

member_count

int64

required

Total number of team members.

[​](#param-budget-count)

budget_count

int64

required

Number of members with a budget configured.

[​](#param-budgets)

budgets

object[]

required

List of team member budget entries.

Hide properties

[​](#param-email)

email

string

required

Member email address.

[​](#param-role)

role

string

required

Member role within the team.

[​](#param-status)

status

string

required

Member account status.

[​](#param-member-id)

member_id

string

required

Sub-user account ID of the member.

[​](#param-phone)

phone

string

required

Member phone number.

[​](#param-user-id)

user_id

string

required

User account ID.

[​](#param-remark-name)

remark_name

string

required

Remark or alias name for the member.

[​](#param-budget-type)

budget_type

string

required

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

[​](#param-budget-limit)

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`.

[​](#param-used)

used

int64

required

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

[​](#param-remaining)

remaining

int64

required

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

[​](#param-cycle)

cycle

string

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

[​](#param-period-start)

period_start

string

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

[​](#param-period-end)

period_end

string

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

```
curl --request GET \
--url https://api.novita.ai/openapi/v1/user/team/budget-list \
--header 'Authorization: Bearer '
```

200

```
{
"member_count": 0,
"budget_count": 0,
"budgets": [
{
"email": "",
"role": "",
"status": "",
"member_id": "",
"phone": "",
"user_id": "",
"remark_name": "",
"budget_type": "",
"budget_limit": 0,
"used": 0,
"remaining": 0,
"cycle": "",
"period_start": "",
"period_end": ""
}
]
}
```

Last modified on April 20, 2026