Rate Limiting
Stay within the per-organization rate limit and back off correctly on 429.
To ensure service stability, the Billy API applies rate limits.
Current Limits
- 600 requests per minute per organization
Handling Limits
When you exceed the limit, the API returns:
- HTTP Code: 429 Too Many Requests
- Header:
Retry-After(number of seconds to wait before retrying) - Body:
{
"detail": "Too Many Requests - backpressure applied (Header 'Retry-After' in seconds)"
}Best Practices
- Use parallel requests moderately (max 5-10 simultaneous)
- Implement exponential backoff in case of 429 error