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

# Kataven Hub API — call limits (cost caps)

> REST API reference for reading per-tenant cost caps. Read-only via API; edited via the Hub UI.

Read your account's per-tenant cost caps. Read-only via the public API — caps are configured by the platform team based on your plan tier. Wrapped by the [Python SDK](/sdks/python/call-limits) and [Node SDK](/sdks/node/call-limits).

## Endpoints at a glance

| Method | Path                                             | Summary                       |
| ------ | ------------------------------------------------ | ----------------------------- |
| `GET`  | [`/api/v1/call-limits`](#get-api-v1-call-limits) | Get this tenant's call limits |

## Reference

### `GET /api/v1/call-limits`

Get this tenant's call limits

Returns the configured caps that gate every outbound originate request. Live counters are not exposed.

**Responses**

| Code  | Description                 | Body                                      |
| ----- | --------------------------- | ----------------------------------------- |
| `200` | OK                          | [`handlers.CallLimitsResponse`](#schemas) |
| `400` | Missing X-Account-ID header | `string`                                  |
| `500` | Database error              | `string`                                  |

**Example**

<CodeGroup>
  ```bash curl theme={null}
  curl https://api.kataven.ai/v1/call-limits \
    -H "Authorization: Bearer $KATAVEN_API_KEY"
  ```

  ```python Python SDK theme={null}
  from kataven import KatavenClient

  client = KatavenClient()  # reads KATAVEN_API_KEY
  client.call_limits.get()
  ```

  ```typescript Node SDK theme={null}
  import { Kataven } from "@kataven/server";

  const client = new Kataven();   // reads KATAVEN_API_KEY
  await client.callLimits.get();
  ```
</CodeGroup>