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

## Request Headers

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

Enum: `application/json`

**Authorization** `string` *required*

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

## Query Parameters

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

The sub-user account ID to query.

## Response Parameters

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

**properties**

**key\_id** `string` *required*

API Key ID.

**key\_name** `string` *required*

API Key name.

**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).

**used** `int64` *required*

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

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

**cycle** `string`

Billing cycle (e.g., `Monthly`). Only present when `budget_type=Recurring`.

**period\_start** `string`

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

**period\_end** `string`

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

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

```json 200 theme={"system"}
{
  "key_budgets": [
    {
      "key_id": "<string>",
      "key_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.