Menu
Amazon API Gateway
Developer Guide

Manage API Request Throttling

Amazon API Gateway throttles API requests to your API using the token bucket algorithm. For more information, see token bucket algorithm.

Account-Level Throttling

By default, API Gateway limits the steady-state request rates to 1000 requests per second (rps) and allows bursts of up to 2000 rps across all APIs, stages, and methods within an AWS account. If necessary, you can request an increase to your account-level limits. For more information, see API Gateway Limits.

You can view account-level throttling limits in the API Gateway console. The console displays the default account-level settings before these settings are overridden by any customization. You can also read the account-level throttling limits by using the API Gateway REST API.

Stage-Level and Method-Level Throttling

As an API owner, you can override the account-level request throttling limits for a specific stage or for individual methods in an API. Actual stage-level and method-level throttling limits are bounded by the account-level rate limits, even if you set the stage-level or method-level throttling limits greater than the account-level limits.

You can set the stage-level or method-level throttling limits by using the API Gateway console or by calling the API Gateway REST API. For instructions using the console, see Set Up a Stage.