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.

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.

Request

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

Headers

Header	Required	Description
Authorization	Yes	Bearer sk-xxx

Examples

cURL

curl https://kiosapi.com/v1/dashboard/billing/subscription \
  -H "Authorization: Bearer sk-xxx"

Python

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']}")

Response

A successful request returns a billing_subscription object:

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