Help Center
Choose product document...
Veeam Backup & Replication 9.5 Update 4
RESTful API Reference

pageSize and page

The pageSize and page query parameters let you control pagination.


Using the pageSize parameter, you can define the number of items to be displayed on one page. As a result, the server will return a set of pages with the defined number of items per page.

By default, all query results are displayed on one page. To set the pageSize parameter, you should pass a value greater than 0 as a query argument.

For example, using the query below, you can paginate a list of backup serves, 1 backup server per page:


GET http://localhost:9399/api/query?type=backupServer&pageSize=1



200 Success


Response Body:

<QueryResult xmlns="">
   <Ref Type="BackupServerReference" Href="http://localhost:9399/api/backupServers/e42211aa-321d-4f91-9c13-2342cf9557eb" Name="" UID="urn:veeam:BackupServer:e42211aa-321d-4f91-9c13-2342cf9557eb">
       <Link Rel="Down" Type="JobReferenceList" Href="http://localhost:9399/api/backupServers/e42211aa-321d-4f91-9c13-2342cf9557eb/jobs" />
       <Link Rel="Down" Type="RepositoryReferenceList" Href="http://localhost:9399/api/backupServers/e42211aa-321d-4f91-9c13-2342cf9557eb/repositories" />
       <Link Rel="Down" Type="CredentialsList" Href="http://localhost:9399/api/backupServers/e42211aa-321d-4f91-9c13-2342cf9557eb/credentials" />
       <Link Rel="Down" Type="PasswordKeyList" Href="http://localhost:9399/api/backupServers/e42211aa-321d-4f91-9c13-2342cf9557eb/passwords" />
       <Link Rel="Alternate" Type="BackupServer" Href="http://localhost:9399/api/backupServers/e42211aa-321d-4f91-9c13-2342cf9557eb?format=Entity" Name="" />
       <Link Rel="Down" Type="ManagedServerReferenceList" Href="http://localhost:9399/api/backupServers/e42211aa-321d-4f91-9c13-2342cf9557eb/managedServers" />
 <PagingInfo PageNum="1" PageSize="1" PagesCount="2">
     <Link Rel="First" Href="http://localhost:9399/api/query?type=backupServer&pageSize=1&page=1" />
     <Link Rel="Next" Href="http://localhost:9399/api/query?type=backupServer&pageSize=1&page=2" />
     <Link Rel="Last" Href="http://localhost:9399/api/query?type=backupServer&pageSize=1&page=2" />


In the PagingInfo section of the returned resource representation, Veeam Backup Enterprise Manager returns URLs to pages with results. The page parameter in the URL defines the number of displayed page.

For example, the page=2 string in the URL below defines that the displayed page is the 2nd page with query results:



pageSize and page Tip:

You can move forward or backward the pages with query results by following the links in PagingInfo section in the query results. Alternatively, you can manually increase or decrease the page number in the query string.


Veeam Large Logo

User Guide for VMware vSphere

User Guide for Microsoft Hyper-V

Enterprise Manager User Guide

Veeam Cloud Connect Guide

Veeam Agent Management Guide

Veeam Explorers User Guide

Backup and Restore of SQL Server Databases

Veeam Plug-ins for Enterprise Applications

PowerShell Reference

Veeam Explorers PowerShell Reference

RESTful API Reference

Required Permissions Reference

Veeam Availability for Nutanix AHV Documentation

Veeam Backup for Microsoft Office 365 Documentation

Veeam ONE Documentation

Veeam Agent for Windows Documentation

Veeam Agent for Linux Documentation

Veeam Management Pack Documentation