<!--
{
  "documentType" : "article",
  "framework" : "AppStoreServerAPI",
  "identifier" : "/documentation/AppStoreServerAPI/identifying-rate-limits",
  "metadataVersion" : "0.1.0",
  "role" : "article",
  "title" : "Identifying rate limits"
}
-->

# Identifying rate limits

Recognize the rate limits that apply to App Store Server API endpoints and handle them in your code.

## Discussion

The App Store Server API limits the number of requests that you can submit to each endpoint within a specified timespan. The request limits apply per app.

The following table lists the rate limits for each endpoint in the production environment, expressed in requests per second. The system enforces rate limits on an hourly basis.

|Endpoint                                                                                                                          |Rate limit (per second)|
|----------------------------------------------------------------------------------------------------------------------------------|----------------------:|
|``doc://com.apple.appstoreserverapi/documentation/AppStoreServerAPI/Finish-Transaction``                                          |50                     |
|``doc://com.apple.appstoreserverapi/documentation/AppStoreServerAPI/Get-App-Transaction-Info``                                    |50                     |
|``doc://com.apple.appstoreserverapi/documentation/AppStoreServerAPI/Get-Transaction-Info``                                        |50                     |
|``doc://com.apple.appstoreserverapi/documentation/AppStoreServerAPI/Get-Transaction-History``                                     |50                     |
|``doc://com.apple.appstoreserverapi/documentation/AppStoreServerAPI/Get-Transaction-History-V1``                                  |50                     |
|``doc://com.apple.appstoreserverapi/documentation/AppStoreServerAPI/Get-All-Subscription-Statuses``                               |50                     |
|``doc://com.apple.appstoreserverapi/documentation/AppStoreServerAPI/Send-Consumption-Information``                                |50                     |
|``doc://com.apple.appstoreserverapi/documentation/AppStoreServerAPI/Send-Consumption-Information-V1``                             |50                     |
|``doc://com.apple.appstoreserverapi/documentation/AppStoreServerAPI/Get-Notification-History``                                    |50                     |
|``doc://com.apple.appstoreserverapi/documentation/AppStoreServerAPI/Extend-a-Subscription-Renewal-Date``                          |20                     |
|``doc://com.apple.appstoreserverapi/documentation/AppStoreServerAPI/Set-App-Account-Token``                                       |20                     |
|``doc://com.apple.appstoreserverapi/documentation/AppStoreServerAPI/Look-Up-Order-ID``                                            |10                     |
|``doc://com.apple.appstoreserverapi/documentation/AppStoreServerAPI/Get-Refund-History``                                          |10                     |
|``doc://com.apple.appstoreserverapi/documentation/AppStoreServerAPI/Get-Refund-History-V1``                                       |10                     |
|``doc://com.apple.appstoreserverapi/documentation/AppStoreServerAPI/Extend-Subscription-Renewal-Dates-for-All-Active-Subscribers``|1                      |
|``doc://com.apple.appstoreserverapi/documentation/AppStoreServerAPI/Request-a-Test-Notification``                                 |1                      |
|``doc://com.apple.appstoreserverapi/documentation/AppStoreServerAPI/Get-Test-Notification-Status``                                |1                      |

The rate limits in the sandbox environment are 10% of the limits in the table above.

The App Store server may make adjustments to reduce or increase these rate limits as needed at any time.

### Handle exceeded rate limits gracefully

If you exceed a per-hour limit, the API rejects the request with an `HTTP` `429` response, with a [`RateLimitExceededError`](/documentation/AppStoreServerAPI/RateLimitExceededError) in the body.  Consider the following as you integrate the API:

- If you periodically call the API, throttle your requests to avoid exceeding the per-hour limit for an endpoint.
- Manage the `HTTP` `429` [`RateLimitExceededError`](/documentation/AppStoreServerAPI/RateLimitExceededError) in your error-handling process. For example, log the failure and queue the job to process it again at a later time.
- Check the `Retry-After` header if you receive the `HTTP` `429` error. This header contains a UNIX time, in milliseconds, that informs you when you can next send a request.

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)