The ReadMe API uses pagination on those endpoints that return lists. There are currently three endpoints that return lists:

Requests that return multiple items will be paginated to 10 items by default. If you want to return multiple pages, you can use the page query parameter. You can also set a custom page size up to 100 with the perPage query parameter.

Like the GitHub API, the Link header also includes pagination information:

Link: </api/v1/changelogs?perPage=10&page=3>; rel="next",
  </api/v1/changelogs?perPage=10&page=1>; rel="prev",
  </api/v1/changelogs?perPage=10&page=8>; rel="last"

The above example includes line breaks for readability.

The possible rel values are:

Name

Description

next

The link relation for the immediate next page of results.

prev

The link relation for the immediate previous page of results.

last

The link relation for the very last page of results.

Additionally, the x-total-count header provides the total number of items, ignoring pagination. See below for an example:

x-total-count: 84