List Overrides

Request

Either namespaceId or namespaceName is required. Not both.

string

The id of the namespace. Either namespaceId or namespaceName must be provided

string

Namespaces group different limits together for better analytics. You might have a namespace for your public API and one for internal tRPC routes. Wildcards can also be used, more info can be found at https://www.unkey.com/docs/ratelimiting/overrides#wildcard-rules

Response

Hide properties

Array

required

Show child attributes

string

required

Identifier of the override requested

string

required

Identifier of your user, this can be their userId, an email, an ip or anything else. Wildcards ( * ) can be used to match multiple identifiers. More info can be found at https://www.unkey.com/docs/ratelimiting/overrides#wildcard-rules

number

required

How many requests may pass in a given window.

number

required

The window duration in milliseconds.

number

required

The total number of overrides

string

The cursor to use for pagination

const { meta, data } = await unkey.listOverrides({
    namespaceName: "email.outbound"
});

const { meta, data } = await unkey.listOverrides({
  nameSpaceId: "rlns_12345",
});

{
  result: {
    overrides: [
       {
        id: 'rlor_1234',
        identifier: 'customer_123',
        limit: 10,
        duration: 50000,
        async: false
      }
    ],
    total: 1,
    cursor: 'rlor_1234'
  }
}

Last modified on May 26, 2026

Delete OverrideDelete a rate limit override for a specific identifier using the @unkey/ratelimit SDK. Revert the identifier to namespace default limits.

⌘I

const { meta, data } = await unkey.listOverrides({
    namespaceName: "email.outbound"
});

const { meta, data } = await unkey.listOverrides({
  nameSpaceId: "rlns_12345",
});

{
  result: {
    overrides: [
       {
        id: 'rlor_1234',
        identifier: 'customer_123',
        limit: 10,
        duration: 50000,
        async: false
      }
    ],
    total: 1,
    cursor: 'rlor_1234'
  }
}

Official Libraries

Community Libraries

Request

Response

​Request

​Response

Request

Response