Pagination with limit and offset in Rest API - Time & Space Complexity
When using pagination with limit and offset in APIs, it's important to understand how the time to get results changes as you ask for different pages.
We want to know how the number of operations grows when we move through pages.
Analyze the time complexity of the following code snippet.
GET /items?limit=10&offset=30
// The server fetches 10 items starting from the 31st item in the list.
// It skips the first 30 items and returns the next 10.
This code fetches a page of items by skipping a number of items (offset) and returning a limited number (limit).
Identify the loops, recursion, array traversals that repeat.
- Primary operation: Skipping items up to the offset before collecting the limited items.
- How many times: The server processes each item up to the offset plus the limit, so roughly offset + limit times.
As the offset grows, the server must skip more items before returning the page.
| Input Size (offset) | Approx. Operations |
|---|---|
| 10 | About 20 (10 skipped + 10 returned) |
| 100 | About 110 (100 skipped + 10 returned) |
| 1000 | About 1010 (1000 skipped + 10 returned) |
Pattern observation: The work grows linearly with the offset because more items are skipped before fetching the page.
Time Complexity: O(offset + limit)
This means the time to get a page grows roughly with how far you skip plus how many items you want to return.
[X] Wrong: "Fetching page 100 is just as fast as page 1 because the limit is the same."
[OK] Correct: Because the server still has to skip all items before the offset, so higher page numbers take more time.
Understanding how pagination affects performance helps you design APIs that stay fast even with many pages. This skill shows you think about real user experience and server work.
"What if we changed offset to use a cursor instead? How would the time complexity change?"
Practice
What does the limit parameter control in pagination?
Solution
Step 1: Understand the role of
Thelimitlimitparameter sets how many items you want to get back in one page of results.Step 2: Differentiate from
Theoffsetoffsetcontrols where to start, not how many items to return.Final Answer:
The number of items to return in one page -> Option DQuick Check:
limit = number of items per page [OK]
- Confusing limit with offset
- Thinking limit controls sorting
- Assuming limit is total items
Which of the following is the correct way to request the second page of results with 10 items per page using limit and offset?
GET /items?limit=10&offset=?
Solution
Step 1: Calculate offset for second page
For page 1, offset is 0. For page 2, offset = limit * (page_number - 1) = 10 * (2 - 1) = 10.Step 2: Confirm limit remains 10
Limit stays 10 to get 10 items per page.Final Answer:
10 -> Option AQuick Check:
offset = limit * (page - 1) = 10 [OK]
- Using offset = page number
- Using offset = limit x page number
- Setting offset to 0 for second page
Given the following API call, what items will be returned if the full list is ["a", "b", "c", "d", "e", "f"]?
GET /items?limit=2&offset=3
Solution
Step 1: Understand offset and limit
Offset 3 means start from the 4th item (0-based index), which is "d".Step 2: Select 2 items from offset
Limit 2 means take 2 items starting at "d", so items are "d" and "e".Final Answer:
["d", "e"] -> Option AQuick Check:
Start at index 3, take 2 items = ["d", "e"] [OK]
- Starting count at 1 instead of 0
- Taking wrong slice of items
- Confusing offset and limit roles
Identify the error in this API call for pagination: GET /items?limit=5&offset=-10
Solution
Step 1: Check offset value
Offset represents the starting position and cannot be negative because you cannot start before the first item.Step 2: Validate limit and offset rules
Limit can be any positive number; offset must be zero or positive.Final Answer:
Negative offset is invalid -> Option CQuick Check:
Offset ≥ 0 required [OK]
- Allowing negative offset
- Confusing limit and offset roles
- Assuming offset can be string
You have 53 items and want to paginate with limit=10. How many pages will you have, and what is the offset for the last page?
Solution
Step 1: Calculate total pages
Total pages = ceiling of total items / limit = ceil(53 / 10) = 6 pages.Step 2: Calculate offset for last page
Offset for last page = limit x (pages - 1) = 10 x (6 - 1) = 50.Final Answer:
6 pages, offset 50 -> Option BQuick Check:
Pages = 6, offset last = 50 [OK]
- Using floor instead of ceiling for pages
- Calculating offset as limit x pages
- Ignoring leftover items on last page
Ready to prove it?
Pass the test and this pattern moves unknown
