Summary
We’re introducing rate limits on the flows querying endpoints in the public API:
- GET /api/v2/flows
- GET /api/v2/flows/divisionviews
The rate limit is a graduated limit that depends on the page size provided in the query.
Rate Examples:
- page size=25 -> 12000 requests/minute
- page size=50 -> 6000 requests/minute
- page size=75 -> 4000 requests/minute
- page size=100 -> 3000 requests/minute
- page size=250 -> 1200 requests/minute
- page size=500 -> 600 requests/minute
Effective Date
Monday, September 01, 2025
Details
We've seen customers hit the flows query endpoint hard with the max page size of 500 which causes throttling on the back end in dynamo. The rate limit mitigates that, and as you can see it's a very generous rate at lower page sizes.
Customer Impact
When the rate limit is breached, the response on the given requests would be a 429 http status code, which would allow clients to retry with backoff.
Impacted Resources
GET /api/v2/flows
GET /api/v2/flows/divisionviews
Issue References
[ADS-5801]
Contacts
@Brian Brian Parsons
Please reply to this announcement with any questions. This helps the wider developer community benefit from the discussion. We encourage you to use this thread before contacting the designated person directly. Thank you for your understanding.