Retrieve a paginated list of all rate limit overrides in a namespace.
Use this to audit rate limiting policies, build admin dashboards, or manage override configurations.
Important: Results are paginated. Use the cursor parameter to retrieve additional pages when more results are available.
Required permissions:
ratelimit.*.read_overrideorratelimit.<namespace_id>.read_override
See the API reference for the full HTTP endpoint documentation.
Usage#
Flags#
The ID or name of the rate limit namespace to list overrides for. Must be 1-512 characters.
Maximum number of override entries to return in a single response. Use this to control response size and loading performance.
- Lower values (10-20): Better for UI displays and faster response times
- Higher values (50-100): Better for data exports or bulk operations
- Default (10): Suitable for most dashboard views
Results exceeding this limit will be paginated, with a cursor provided for fetching subsequent pages. Must be between 1 and 100.
Pagination cursor from a previous response. Include this when fetching subsequent pages of results. Each response containing more results than the requested limit will include a cursor value that can be used here.
Global Flags#
| Flag | Type | Description |
|---|---|---|
--root-key | string | Override root key ($UNKEY_ROOT_KEY) |
--api-url | string | Override API base URL (default: https://api.unkey.com) |
--config | string | Path to config file (default: ~/.unkey/config.toml) |
--output | string | Output format. Use json for raw JSON |
--body | string | Send this JSON string as the request body. You cannot combine it with request-building flags. |
Examples#
Output#
Default output shows the request ID, followed by the list of overrides:
With --output=json, the full response envelope is returned: