The answer
Returning every user in one response is slow, uses memory, and breaks clients. Cap the response with a limit (max 100). Use skip and limit, or cursor-based. Return total for offset pagination.
Common API Design Mistakes (and How to Avoid Them)
Why is no pagination a problem in APIs?
More FAQs in Common API Design Mistakes (and How to Avoid Them)
Verbs in paths, wrong status codes, no versioning, no pagination, inconsistent response shapes, exposing internals, no validation, GET with side effects, no error format, deep nesting, no rate limiting, and no documentation.
Because the HTTP method is the verb. /users, not /getUsers. /users/:id, not /getUserById. Plural nouns for collections. This is the REST convention and matches what clients expect.
So clients can rely on the shape. If one endpoint returns { error: 'msg' } and another returns { errors: [...] }, clients have to special-case each one. Pick one shape (e.g., { error: 'msg', code: 'X' }) and use it everywhere.
Still have questions?
Browse all our FAQs or reach out to our support team
Want to upskill yourself?
Your learning library
Small steps. Big possibilities.
Find your next course. Build something great.