Admin API rate limit changes
November 12th, 2025
We've redesigned our rate limiting system to provide better predictability and higher throughput for API requests.
What Changed?
Previous Behaviour Each endpoint had its own low rate limit. Developers had to write different code for each endpoint, and many requests kept getting rate-limited due to low capacity.
New Behaviour We now use a two-pool rate limit system that provides greater flexibility and dedicated capacity for your API operations:
Global Pool
- Limit: 10 requests per second per store
- Applies to: All endpoints that don't have a specific override
- Purpose: Ensures overall API stability
Endpoint-Specific Rate Limits
- Purpose: Provides dedicated capacity for certain operations
- Independence: These limits operate separately from the global limit
- Benefit: Allows you to make calls to these endpoints without affecting your global limit quota
Benefits
- Simplified development: Write consistent rate limit handling code across your application
- Higher throughput: Endpoint-specific limits don't consume your global quota
- Better predictability: Clear, documented limits for planning your API usage
- Reduced rate limiting: Higher capacity means fewer failed requests
Migration Guide
If your application currently implements per-endpoint rate limit handling:
- Update your rate limit logic: You can now use a unified approach for most endpoints, checking against the global 10 requests/second limit
- Review endpoint-specific limits: Check which endpoints have dedicated capacity that won't affect your global quota
- Test your implementation: Verify that your application handles the new rate limit headers correctly
Things to Keep in Mind
- The global pool applies a 10 requests per second limit across all standard endpoints
- Endpoint-specific rate limits operate independently and don't consume your global quota
- Monitor the rate limit headers in API responses to track your current usage and remaining capacity
- Plan your API calls to optimize usage of both global and endpoint-specific limits
For complete details on the new rate limiting system, including which endpoints have specific overrides, see Admin API rate limits documentation.