# Query API Key Budget List for a Member - 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-key-list

# Query API Key Budget List for a Member

GET

/

openapi

/

v1

/

user

/

team

/

key-budget-list

Try it

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

200

```
{
"key_budgets": [
{
"key_id": "",
"key_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}}.

##

[​](#query-parameters)

Query Parameters

[​](#param-member-id)

member_id

string

required

The sub-user account ID to query.

##

[​](#response-parameters)

Response Parameters

[​](#param-key-budgets)

key_budgets

object[]

required

List of API Key budget entries for the specified member. API Keys with no budget configured appear in the list with default values (`budget_type=Unlimited`, `used=0`, `budget_limit=0`).

Hide properties

[​](#param-key-id)

key_id

string

required

API Key ID.

[​](#param-key-name)

key_name

string

required

API Key name.

[​](#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).

[​](#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 amount, 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 (e.g., `Monthly`). Only present when `budget_type=Recurring`.

[​](#param-period-start)

period_start

string

Current billing period start time, formatted as an ISO 8601 string. Only present when `budget_type=Recurring`.

[​](#param-period-end)

period_end

string

Current billing period end time, formatted as an ISO 8601 string. Only present when `budget_type=Recurring`.

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

200

```
{
"key_budgets": [
{
"key_id": "",
"key_name": "",
"budget_type": "",
"budget_limit": 0,
"used": 0,
"remaining": 0,
"cycle": "",
"period_start": "",
"period_end": ""
}
]
}
```

Last modified on April 20, 2026