Pagination

Pagination query parameters are page and limit. The max number of items per pages is set to 200, value up to this limit will be ignored.

The collection expose properties about pagination info:

  • total Total items count for the resource
  • count Current item number displayed
  • pages Total number of pages for the resource
  • page Current page number
  • limit Current limit used for items count per page

The various relational links for the collection make it trivial to traverse the API to get a full list of resources in the collection. You can easily determine what page you are on, and what the next page should be (and if you are on the last page)

Out of range page request

If an invalide page is requested for the resource, the API will return a ApiProblem Conflict (409) response.

HTTP/1.1 409 Conflict
Content-Type: application/problem+json

{
    "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html",
    "title":"Conflict",
    "detail":"requested page is out of range",
    "status":409,
    "pages":6,
    "page":100
}

Where:

  • pages The total number of page
  • page The current requested page