Overview

Use queryMore() to request additional results from a previous query() call. If your initial query() call returns more than 2000 results, you can use queryMore() to query for the additional results.  This SOAP API reference describes this call.

Usage

This call sends a request for additional results from an initial query() call. If the initial query() call returns more than 2000 results, you can use the queryLocator returned from query() to request the next set of results. By default, 2000 results will be returned with the queryMore() call, but this can be changed by setting batchSize in QueryOptions.

You can set the number of results to return by setting BatchSize in SOAP header. It can be a number between 0 and 2000. Setting to 0 is the default setting, which will return 2000 results.

Syntax and Arguments

To use queryMore(), you first construct a query() call. By default, the query() call will return up to 2000 results. If there are more than 2000 results, query() will return a boolean "done," which will be marked as false, and a queryLocator, which is a marker you will pass to queryMore() to get the next set of results.

Example of Using queryMore()

A typical request could be:

Typically, Zuora would return 2000 results (100 results with WSDL version 5.0 and below). However, if your query exceeds this limit, you can use queryMore() to request the remaining results.

The following is an example that makes a query and requests that only 50 results be returned.

The resulting response would be: