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

# Query API Key Budget List for a Member

## Request Headers

<ParamField header="Content-Type" type="string" required={true}>
  Enum: `application/json`
</ParamField>

<ParamField header="Authorization" type="string" required={true}>
  Bearer authentication format, for example: Bearer \{\{API Key}}.
</ParamField>

## Query Parameters

<ParamField query="member_id" type="string" required={true}>
  The sub-user account ID to query.
</ParamField>

## Response Parameters

<ResponseField name="key_budgets" type="object[]" required={true}>
  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`).

  <Expandable title="properties" defaultOpen={true}>
    <ResponseField name="key_id" type="string" required={true}>
      API Key ID.
    </ResponseField>

    <ResponseField name="key_name" type="string" required={true}>
      API Key name.
    </ResponseField>

    <ResponseField name="budget_type" type="string" required={true}>
      Budget type. Possible values: `Unlimited`, `One-time`, `Recurring`.
    </ResponseField>

    <ResponseField name="budget_limit" type="int64" required={true}>
      Budget limit, in units of 1/10000 USD (e.g., 10000 = \$1.00).
    </ResponseField>

    <ResponseField name="used" type="int64" required={true}>
      Amount used, in units of 1/10000 USD (e.g., 10000 = \$1.00).
    </ResponseField>

    <ResponseField name="remaining" type="int64" required={true}>
      Remaining budget amount, in units of 1/10000 USD (e.g., 10000 = \$1.00). May be negative when usage exceeds the limit.
    </ResponseField>

    <ResponseField name="cycle" type="string" required={false}>
      Billing cycle (e.g., `Monthly`). Only present when `budget_type=Recurring`.
    </ResponseField>

    <ResponseField name="period_start" type="string" required={false}>
      Current billing period start time, formatted as an ISO 8601 string. Only present when `budget_type=Recurring`.
    </ResponseField>

    <ResponseField name="period_end" type="string" required={false}>
      Current billing period end time, formatted as an ISO 8601 string. Only present when `budget_type=Recurring`.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```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>'
  ```
</RequestExample>

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