Query API Key Budget List for a Member

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

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

GET

openapi

user

team

key-budget-list

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

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

Request Headers

string

required

Enum: application/json

string

required

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

Query Parameters

string

required

The sub-user account ID to query.

Response Parameters

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

string

required

API Key ID.

string

required

API Key name.

string

required

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

int64

required

Budget limit, in units of 1/10000 USD (e.g., 10000 = $1.00).

int64

required

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

int64

required

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

string

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

string

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

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=<string>' \
  --header 'Authorization: Bearer <API_KEY>'

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

Last modified on April 20, 2026

Check If Member Budget Is Sufficient for a Given Cost Update API Key Budget Configuration

Overview

Basic

Quota

Team Budget

API Key Model Access

Model APIs

GPUs

Query API Key Budget List for a Member

Request Headers

Query Parameters

Response Parameters

​Request Headers

​Query Parameters

​Response Parameters

Request Headers

Query Parameters

Response Parameters