Skip to main content

11 May 2026

Paged responses: totalItemCount and pageCount are gone, and pageNumber is now page​

The envelope every list endpoint returns has changed. pageNumber is renamed to page, and the two totals, totalItemCount and pageCount, have been removed. This is a breaking change to every list endpoint.

Counting the whole result set on every request is what made large lists slow, and no total can be returned without doing it. To walk a list, read hasNextPage and request the next page while it is true, rather than dividing a total by your page size. If you display a count, you will need to stop showing one, or count what you have fetched. items, links and pageSize are unchanged.

Before:

{
  "pageNumber": 1,
  "pageSize": 10,
  "totalItemCount": 438,
  "pageCount": 44,
  "hasNextPage": true
}

After:

{
  "page": 1,
  "pageSize": 10,
  "hasNextPage": true
}