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

# Check Your KiosAPI API Token Spending Quota and Limits

> Query the authorized spending limit for your KiosAPI API token via GET /v1/dashboard/billing/subscription, with soft and hard USD limits.

You can query the authorized spending limit (quota) for your API token programmatically at any time. The endpoint returns both the soft and hard USD limits currently applied to the token, letting you monitor and enforce budget constraints from your own tooling.

<Info>
  If a token is set to **unlimited quota**, the query result returns `100000000`. When a token's quota is modified, the new limit accumulates on top of the previous amount rather than replacing it.
</Info>

## Request

**Method:** `GET`
**URL:** `https://kiosapi.com/v1/dashboard/billing/subscription`

### Headers

| Header          | Required | Description     |
| --------------- | -------- | --------------- |
| `Authorization` | Yes      | `Bearer sk-xxx` |

### Examples

<Tabs>
  <Tab title="cURL">
    ```bash theme={null}
    curl https://kiosapi.com/v1/dashboard/billing/subscription \
      -H "Authorization: Bearer sk-xxx"
    ```
  </Tab>

  <Tab title="Python">
    ```python theme={null}
    import requests

    url = "https://kiosapi.com/v1/dashboard/billing/subscription"
    headers = {"Authorization": "Bearer sk-xxx"}

    response = requests.get(url, headers=headers)
    data = response.json()

    print(f"Hard limit: ${data['hard_limit_usd']}")
    print(f"Soft limit: ${data['soft_limit_usd']}")
    ```
  </Tab>
</Tabs>

## Response

A successful request returns a `billing_subscription` object:

```json theme={null}
{
  "object": "billing_subscription",
  "has_payment_method": true,
  "soft_limit_usd": 5,
  "hard_limit_usd": 5,
  "system_hard_limit_usd": 5,
  "access_until": 0
}
```

### Response Schema

| Field                   | Type    | Description                                                      |
| ----------------------- | ------- | ---------------------------------------------------------------- |
| `object`                | string  | Always `billing_subscription`                                    |
| `has_payment_method`    | boolean | Whether a payment method is on file for the account              |
| `soft_limit_usd`        | integer | Soft spending limit in USD; triggers a warning when reached      |
| `hard_limit_usd`        | integer | Hard spending limit in USD; blocks further requests when reached |
| `system_hard_limit_usd` | integer | Platform-level hard limit in USD set by KiosAPI                  |
| `access_until`          | integer | Unix timestamp after which access expires; `0` means no expiry   |