APIAPI reference
Workspace request rate and latest increase request
GET /v1/rate-limit
GET /v1/rate-limit
Web session with usage:read or limits:read. Rolling windows cover REST, MCP and sandbox.
Authorization
This operation requires a bearer credential. The description defines additional role, scope or first-party-session restrictions; an API key does not grant those permissions by itself.
Request body
No request body.
Responses
| HTTP | Details | Type |
|---|---|---|
| 200 | Successful Response | application/json: RateLimitInfo |
| 401 | Unauthorized | application/problem+json: ProblemDetails |
| 403 | Forbidden | application/problem+json: ProblemDetails |
| 404 | Not Found | application/problem+json: ProblemDetails |
| 422 | Unprocessable Entity | application/problem+json: ProblemDetails |
Response: RateLimitInfo
| Property | Type | Required | Details |
|---|---|---|---|
limiter | string | yes | |
window_behavior | string | yes | |
plan_rpm | integer | yes | |
effective_rpm | integer | yes | |
override_rpm | integer ∣ null | yes | |
window_seconds | integer | yes | |
burst_limit | integer | yes | |
burst_window_seconds | integer | yes | |
latest_request | RateLimitRequest ∣ null | yes |
Full schema
{
"properties": {
"limiter": {
"type": "string",
"const": "better-auth",
"title": "Limiter"
},
"window_behavior": {
"type": "string",
"const": "inactivity",
"title": "Window Behavior"
},
"plan_rpm": {
"type": "integer",
"title": "Plan Rpm"
},
"effective_rpm": {
"type": "integer",
"title": "Effective Rpm"
},
"override_rpm": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Override Rpm"
},
"window_seconds": {
"type": "integer",
"const": 60,
"title": "Window Seconds"
},
"burst_limit": {
"type": "integer",
"title": "Burst Limit"
},
"burst_window_seconds": {
"type": "integer",
"const": 10,
"title": "Burst Window Seconds"
},
"latest_request": {
"anyOf": [
{
"$ref": "#/components/schemas/RateLimitRequest"
},
{
"type": "null"
}
]
}
},
"type": "object",
"required": [
"limiter",
"window_behavior",
"plan_rpm",
"effective_rpm",
"override_rpm",
"window_seconds",
"burst_limit",
"burst_window_seconds",
"latest_request"
],
"title": "RateLimitInfo"
}This page is generated from OpenAPI; examples are schemas, not a fabricated successful response.