API throttling limits

Throttling is the process of limiting the number of requests you (or your authorized developer) can submit to a given operation in a given amount of time. Throttling protects the web service from being overwhelmed with requests and ensures all authorized developers have access to the web service. Requests that have been throttled will return a 429 HTTP status code, see error handling for information on how to handle throttled requests.

Key terms:

  • Request quota - The number of requests that you can submit at one time without throttling. The request quota decreases with each request you submit, and increases at the restore rate (measured in seconds). Requests are calculated for each Amazon seller account and Amazon MWS developer account pair.
  • Max quota (also called the burst rate) - The maximum size that the request quota can reach.
  • Restore rate (also called the recovery rate) - The rate at which your request quota increases over time measured in seconds, up to the maximum request quota.

 
API
Live
Sandbox

Max quota
Restore rate
Max quota
Restore rate
Cancel Charge
10
1
2
1
Capture Charge
20
2
2
1
Close Charge Permission
10
1
2
1
Complete Checkout Session
20
2
2
1
Create Charge
10
1
2
1
Create Checkout Session
40
4
2
1
Create Merchant Account
10
1
1
1
Create Refund
10
1
2
1
Create Delivery Tracker
10
1
1
1
Get Authorization Token
5
1
N/A
N/A
Get Charge
20
2
5
1
Get Charge Permission
20
2
5
1
Get Checkout Session
40
4
5
1
Get Merchant Status
10
1
1
1
Get Refund
20
2
5
1
Update Charge Permission
10
1
2
1
Update Checkout Session
20
2
2
1
 
API
Live
Sandbox

Max quota
Restore rate
Max quota
Restore rate
Cancel Charge
10
1
2
1
Capture Charge
20
2
2
1
Close Charge Permission
10
1
2
1
Complete Checkout Session
20
2
2
1
Create Charge
10
1
2
1
Create Checkout Session
40
4
2
1
Create Refund
10
1
2
1
Create Delivery Tracker
10
1
1
1
Get Authorization Token
5
1
N/A
N/A
Get Charge
20
2
5
1
Get Charge Permission
20
2
5
1
Get Checkout Session
40
4
5
1
Get Refund
20
2
5
1
Update Charge Permission
10
1
2
1
Update Checkout Session
20
2
2
1
 
API
Live
Sandbox

Max quota
Restore rate
Max quota
Restore rate
Cancel Charge
10
1
2
1
Capture Charge
20
1
2
1
Close Charge Permission
10
1
2
1
Complete Checkout Session
20
2
2
1
Create Charge
10
1
2
1
Create Checkout Session
40
4
2
1
Create Merchant Account
10
1
1
1
Create Refund
10
1
2
1
Create Delivery Tracker
10
1
1
1
Get Authorization Token
5
1
N/A
N/A
Get Charge
20
2
5
1
Get Charge Permission
20
2
5
1
Get Checkout Session
40
4
5
1
Get Merchant Status
10
1
1
1
Get Refund
20
2
5
1
Update Charge Permission
10
1
2
1
Update Checkout Session
20
2
2
1