---
title: DefaultRateThrottlingPolicy
description: Configure DefaultRateThrottlingPolicy in PingGateway to provide a fallback throttling rate when a delegating throttling rate policy returns null
component: pinggateway
version: 2026
page_id: pinggateway:reference:DefaultRateThrottlingPolicy
canonical_url: https://docs.pingidentity.com/pinggateway/2026/reference/DefaultRateThrottlingPolicy.html
revdate: 2025-06-02T18:01:47Z
section_ids:
  DefaultRateThrottlingPolicy-usage: Usage
  DefaultRateThrottlingPolicy-properties: Properties
  DefaultRateThrottlingPolicy-example: Example
  DefaultRateThrottlingPolicy-moreinfo: More information
---

# DefaultRateThrottlingPolicy

Provides a default throttling rate if the delegating throttling policy returns `null`.

## Usage

```json
{
   "name": string,
   "type": "ThrottlingFilter",
   "config": {
       "requestGroupingPolicy": expression,
       "throttlingRatePolicy": {
           "type": "DefaultRateThrottlingPolicy",
           "config": {
               "delegateThrottlingRatePolicy": ThrottlingRatePolicy reference,
               "defaultRate": {
                   "numberOfRequests": configuration expression<number>,
                   "duration": configuration expression<duration>
               }
           }
       }
   }
}
```

## Properties

* `"delegateThrottlingRatePolicy"`: *ThrottlingRatePolicy [reference](preface.html#definition-reference), required*

  The policy to which the default policy delegates the throttling rate. The `DefaultRateThrottlingPolicy` delegates management of throttling to the policy specified by `delegateThrottlingRatePolicy`.

  If `delegateThrottlingRatePolicy` returns `null`, the `defaultRate` is used.

  For information about policies to use, refer to [MappedThrottlingPolicy](MappedThrottlingPolicy.html) and [ScriptableThrottlingPolicy](ScriptableThrottlingPolicy.html).

* `"defaultRate"`: *[object](preface.html#definition-object), required*

  The default throttling rate to apply if the delegating policy returns `null`.

- `"numberOfRequests"`: *configuration expression\<integer>, required*

  The number of requests allowed through the filter in the time specified by `"duration"`.

* `"duration"`: *configuration expression<[duration](preface.html#definition-duration)>, required*

  A time interval during which the number of requests passing through the filter is counted.

## Example

For an example of how this policy is used, refer to [Example of a scriptable throttling policy](ScriptableThrottlingPolicy.html#example-throttling-scriptable).

## More information

[org.forgerock.openig.filter.throttling.DefaultRateThrottlingPolicyHeaplet](../_attachments/apidocs/org/forgerock/openig/filter/throttling/DefaultRateThrottlingPolicyHeaplet.html)