UNunkeyed
ratelimit

List ratelimit overrides

Changed on

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.

Permissions: Requires ratelimit.*.read_override or ratelimit.<namespace_id>.read_override

post/v2/ratelimit.listOverrides

Request

  • Base URL
    https://api.unkey.com
  • URL
    https://api.unkey.com/v2/ratelimit.listOverrides
  • Auth
    HTTP bearer

Request body

namespacestring required

The id or name of the rate limit namespace to list overrides for.

cursorstring

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 in the pagination object that can be used here.

limitinteger

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.

Response

Overrides retrieved successfully. Includes pagination metadata if more results are available.

Example response

{
  "meta": {
    "requestId": "req_123"
  },
  "pagination": {
    "cursor": "eyJrZXkiOiJrZXlfMTIzNCIsInRzIjoxNjk5Mzc4ODAwfQ==",
    "hasMore": true
  }
}

Changes

  • 89f6a753ffaeRevision changes
    • info

      the request property's maxLength was increased from 255 to 512

  • 43ad1ce9a152Revision changes
    • info

      the endpoint scheme security bearer was added to the API

    • info

      the endpoint scheme security rootKey was removed from the API