---
title: "Get User Rate Limit"
method: GET
path: "/api/copilot/admin/rate_limit"
tags: ["v2", "admin", "copilot", "admin"]
---

# Get User Rate Limit

`GET /api/copilot/admin/rate_limit`

Get a user's current usage and effective rate limits. Admin-only.

Accepts either ``user_id`` or ``email`` as a query parameter.
When ``email`` is provided the user is looked up by email first.

## Query parameters

- `user_id` string, nullable
- `email` string, nullable

## Response `200`

Successful Response

- UserRateLimitResponse
  - `user_id` string, required
  - `user_email` string, nullable
  - `daily_cost_limit_microdollars` integer, required
  - `weekly_cost_limit_microdollars` integer, required
  - `daily_cost_used_microdollars` integer, required
  - `weekly_cost_used_microdollars` integer, required
  - `tier` 'NO_TIER' | 'BASIC' | 'PRO' | 'MAX' | 'BUSINESS' | 'ENTERPRISE', required — Subscription tiers with increasing cost allowances. Mirrors the ``SubscriptionTier`` enum in ``schema.prisma``. Once ``prisma generate`` is run, this can be replaced with:: from prisma.enums import SubscriptionTier
  - `tier_multipliers` object

## Other responses

- `401` — Authentication required
- `422` — Validation Error

---

[API](https://skmtc.net/significant-gravitas/apis/autogpt-agent-server.md) · [All operations](https://skmtc.net/significant-gravitas/apis/autogpt-agent-server/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/significant-gravitas/autogpt-agent-server/versions/382041c7ecb2/schema)