How to complete the challenge `GET /todos (200) ?_limit`

By Alan RichardsonPublished 2026-07-30

How to issue a GET request on a top level entity endpoint and use pagination to limit the returned todos.

GET /todos (200) ?_limit

Issue a GET request on the /todos end point with a pagination limit to retrieve up to 8 todos.

_limit controls the maximum number of todos returned
the maximum supported _limit value is 20
this challenge is passed by requesting up to 8 todos and receiving a 200 response
if your current session has fewer than 8 todos, the response will contain fewer todos

Basic Instructions

Issue a GET request to end point "/todos"
- https://apichallenges.com/todos
The request should have an X-CHALLENGER header to track challenge completion
Add _limit=8 as a URL parameter:
- https://apichallenges.com/todos?_limit=8
The response status code should be 200 because the request is accepted
Check that the response body contains no more than 8 todos

Try it now

GET /todos?_limit=8 to limit the number of todos returned

Example Request

> GET /todos?_limit=8 HTTP/1.1
> Host: apichallenges.com
> User-Agent: rest-client
> X-CHALLENGER: x-challenger-guid
> Accept: application/json

Example Response

< HTTP/1.1 200 OK
< Connection: close
< Content-Type: application/json
< X-Challenger: x-challenger-guid

Returned body:

{
  "todos": [
    { "id": 1, "title": "scan paperwork", "doneStatus": false, "description": "" },
    { "id": 2, "title": "file paperwork", "doneStatus": false, "description": "" },
    { "id": 3, "title": "process payroll", "doneStatus": false, "description": "" },
    { "id": 4, "title": "review invoices", "doneStatus": false, "description": "" },
    { "id": 5, "title": "update calendar", "doneStatus": false, "description": "" },
    { "id": 6, "title": "archive notes", "doneStatus": false, "description": "" },
    { "id": 7, "title": "send report", "doneStatus": false, "description": "" },
    { "id": 8, "title": "book meeting", "doneStatus": false, "description": "" }
  ]
}

Experiment with this endpoint

How to complete the challenge GET /todos (200) ?_limit