Pagination

A v2 list route returns one page at a time. Each response carries a cursor for the next page, and an empty cursor means you have the last one. Pass the cursor back exactly as you received it: it is opaque, so don’t build or edit one. v1 pages differently, with a whole URL (see the aside at the end).

Walking the pages

1. Request the first page with no cursor.
2. Read the next cursor from the response. If it is empty, you are done.
3. Otherwise, send the same request again with cursor set to that value.

GET /v2/storefront/orders/shipped?lastUpdatedTs=2026-09-22T14:00:00Z&pageSize=50

{
  "orders": [],
  "nextPageCursor": "c29tZS1vcGFxdWUtY3Vyc29y"
}

GET /v2/storefront/orders/shipped?lastUpdatedTs=2026-09-22T14:00:00Z&pageSize=50&cursor=c29tZS1vcGFxdWUtY3Vyc29y

The cursor does not carry your filters. Each page reads them from the request, so send the same ones every time and change only cursor.

The field name depends on the service

Every paged v2 route takes cursor in. The name of the cursor that comes back differs:

Routes	Next cursor
Orders and listing	nextPageCursor
Inventory	nextCursor
Shipping	nextCursor

Page size

Where a route takes pageSize, leave it out for the server default. Each service sets its own default and maximum, and a larger pageSize is lowered to the maximum rather than rejected. The listing routes take no pageSize at all.

On the orders and inventory routes, a cursor the service cannot read answers 400 with invalid cursor in the message. See Errors.

Legacy (v1)

A paged v1 response carries a pagination object alongside results:

{
  "results": [],
  "pagination": {
    "hasNext": true,
    "nextToken": "https://api.zentail.com/v1/salesOrder?nextToken=..."
  }
}

Read hasNext. While it is true, send a GET to nextToken, which is null on the last page.

nextToken is a whole URL, not a value to append. Request it exactly as given, with no query parameters of your own. The parameters from the first call are stored server-side and reapplied for you, so only that first call carries filters such as lastUpdatedTs.

A token is scoped to the endpoint that issued it. Replaying a /salesOrder token against /inventory answers 404 with NextToken '...' not valid for this endpoint.

pageLength sets the page size, up to a documented maximum of 100. With no pageLength, the endpoint’s own default applies:

Endpoint	Default pageLength
GET /salesOrder	10
GET /listing	25
GET /product	25
GET /report	25
GET /inboundShipment	25

GET /inventory pages the same way.

See also

• Timestamp formats — the timestamp you poll from.
• Errors — what a bad cursor or a stale nextToken answers.