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

# Get User Quota

> Retrieve the authenticated user's usage quota and limits.

# Get User Quota

Retrieve usage quota information for the currently authenticated user, including limits and current usage.

## Authentication

Requires JWT token authentication.

```bash theme={null}
Authorization: Bearer <jwt_token>
```

## Example Request

```bash theme={null}
curl -X GET https://api.app.shinzo.ai/auth/fetch_user_quota \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."
```

## Response

```json theme={null}
{
  "plan": "free",
  "quotas": {
    "agents": {
      "limit": 3,
      "used": 1
    },
    "telemetry_events_per_month": {
      "limit": 100000,
      "used": 45230
    },
    "api_requests_per_minute": {
      "limit": 1000,
      "used": 0
    }
  },
  "features": {
    "ai_agents": true,
    "spotlight": true,
    "advanced_analytics": false
  }
}
```

## Response Fields

| Field      | Type   | Description                                          |
| ---------- | ------ | ---------------------------------------------------- |
| `plan`     | string | User's subscription plan                             |
| `quotas`   | object | Usage limits and current usage for various resources |
| `features` | object | Feature flags indicating which features are enabled  |

## Status Codes

| Code  | Description              |
| ----- | ------------------------ |
| `200` | Success                  |
| `401` | Invalid or missing token |