All top-level API resources have support for bulk fetches via the "List" API methods. For instance, you can list accounts, list subscriptions and list billing documents. These list API methods share a common structure - taking an optional cursor parameter.

Zuora uses cursor-based pagination via the cursor query parameter. The cursor parameter takes the next_page value returned in the response returned from a previous request. Objects are returned, by default, in reverse chronological order.


cursor(string): a cursor for use in pagination. cursor defines your place in the list. For instance, if you make a "List" request and receive 10 objects, with next_page=76683efa-4b25-4716-a5c1-852b2162fcdb, your subsequent call can include cursor=76683efa-4b25-4716-a5c1-852b2162fcdb to fetch the next page of the list.

List Response Format

  • data(array): an array containing the actual response elements, paginated by any request parameters.

    The default page_size value for all "List" endpoints is 30, except for the List billing documents operation. The page_size parameter is not fully supported by the "List billing documents" operation. By default, you will get between 30 and 90 billing documents for each page when calling this operation.

  • next_page(string): a cursor you can use to fetch the next page of the list.