API Design · Senior · Question 75 of 75

Where should quotas and rate limits per plan be documented?

1Nowhere; clients should discover them by trial
2Only in internal wikis
✓Correct answer: In the public docs and returned in response headers, so clients can plan capacity and react before hitting limits

Explanation

Predictable limits reduce support load and prevent clients from building fragile retry loops.

Further reading

Test yourself

Take the API Design · Senior quiz: questions and options are shuffled, and you get a review of your mistakes at the end.