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

# Get Current Usage

> Returns your current resource usage and plan limits for the current billing period

## Get Current Usage

```http theme={"dark"}
GET /v1/account/usage
```

Returns your current resource usage and plan limits for the current billing period. Use this to monitor how close you are to hitting plan limits before creating new resources.

### Response

```json theme={"dark"}
{
  "data": {
    "billing_period": {
      "year": 2026,
      "month": 3,
      "start": "2026-03-01T00:00:00.000Z",
      "end": "2026-03-31T23:59:59.000Z"
    },
    "api_calls": {
      "used": 12847,
      "limit": 100000,
      "percentage": 12.85
    },
    "resources": {
      "routes": { "used": 8, "limit": 50 },
      "secrets": { "used": 12, "limit": 100 },
      "clients": { "used": 5, "limit": 25 },
      "environments": { "used": 3, "limit": null }
    },
    "plan": "pro",
    "status": "active"
  },
  "meta": { "request_id": "550e8400-e29b-41d4-a716-446655440000" }
}
```

<Note>
  A `limit` of `null` means the resource is unlimited on your current plan.
</Note>

<CodeGroup>
  ```bash cURL theme={"dark"}
  curl https://api.knoxcall.com/v1/account/usage \
    -H "Authorization: Bearer tk_live_abc123..."
  ```

  ```python Python theme={"dark"}
  import requests

  resp = requests.get(
      "https://api.knoxcall.com/v1/account/usage",
      headers={"Authorization": "Bearer tk_live_abc123..."}
  )
  usage = resp.json()["data"]
  print(f"API calls: {usage['api_calls']['used']}/{usage['api_calls']['limit']}")
  ```

  ```javascript Node.js theme={"dark"}
  const resp = await fetch("https://api.knoxcall.com/v1/account/usage", {
    headers: { Authorization: "Bearer tk_live_abc123..." }
  });
  const { data: usage } = await resp.json();
  console.log(`API calls: ${usage.api_calls.used}/${usage.api_calls.limit}`);
  ```
</CodeGroup>