> ## Documentation Index
> Fetch the complete documentation index at: https://unkey.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# List Overrides

> List all rate limit overrides in a namespace using the @unkey/ratelimit SDK. Retrieve paginated results of custom limits for identifiers.

## Request

<Warning>
  Either `namespaceId` or `namespaceName` is required. Not both.
</Warning>

<ParamField body="namespaceId" type="string">
  The id of the namespace. Either namespaceId or namespaceName must be provided
</ParamField>

<ParamField body="namespaceName" type="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](https://www.unkey.com/docs/ratelimiting/overrides#wildcard-rules)
</ParamField>

## Response

<ResponseField name="result">
  <Expandable title="properties" defaultOpen>
    <ResponseField name="overrides" type="Array" required>
      <Expandable>
        <ParamField body="id" type="string" required>
          Identifier of the override requested
        </ParamField>

        <ParamField body="identifier" type="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](https://www.unkey.com/docs/ratelimiting/overrides#wildcard-rules)
        </ParamField>

        <ParamField body="limit" type="number" required>
          How many requests may pass in a given window.
        </ParamField>

        <ParamField body="duration" type="number" required>
          The window duration in milliseconds.
        </ParamField>
      </Expandable>
    </ResponseField>

    <ResponseField name="total" type="number" required>
      The total number of overrides
    </ResponseField>

    <ResponseField name="cursor" type="string" optional>
      The cursor to use for pagination
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```ts theme={"theme":"kanagawa-wave"}
  const { meta, data } = await unkey.listOverrides({
      namespaceName: "email.outbound"
  });
  ```

  ```ts theme={"theme":"kanagawa-wave"}
  const { meta, data } = await unkey.listOverrides({
    nameSpaceId: "rlns_12345",
  });
  ```
</RequestExample>

<ResponseExample>
  ```ts theme={"theme":"kanagawa-wave"}
  {
    result: {
      overrides: [
         {
          id: 'rlor_1234',
          identifier: 'customer_123',
          limit: 10,
          duration: 50000,
          async: false
        }
      ],
      total: 1,
      cursor: 'rlor_1234'
    }
  }
  ```
</ResponseExample>