Skip to main content

Pagination

Daniel Ferguson avatar
Written by Daniel Ferguson
Updated over a month ago

Some endpoints use keyset pagination to return data in chunks, rather than all at once.

  • X-Has-Next-Page is true if more data is available; otherwise, it’s false.

  • X-Per-Page indicates the number of items returned in each response.

Paginated endpoints will also return an extra key in the JSON body called pagination. For example, a response might look like this:

X-Has-Next-Page: true
X-Per-Page: 5

{
"data": {...},
"pagination": {
"pageSize": 5,
"next": "01999999-aaaa-bbbb-cccc-123412341234"
}
}

To fetch the next page, use the next query parameter with the ID returned in the pagination.next field.

https://app.visibuild.com.au/api/core/v1/projects?next=01999999-aaaa-bbbb-cccc-123412341234

If there are no more pages, the next field will be null and X-Has-Next-Page will be false:

X-Has-Next-Page: false
X-Per-Page: 5

{
"data": {...},
"pagination": {
"pageSize": 5,
"next": null
}
}
Did this answer your question?