Pagination

Limit

To limit response results limit parameter is used.

• limit – default 100, max - 250.

To get paged results, pass this parameter in query.

Example: GET https://api.omnisend.com/v3/carts?limit=20

Important: please check response statusCode and if not 2xx code is returned - stop fetching results.

Next and previous pages

In paged response you'll get paging object with parameters:

• previous - link to get previous results (if available)
• next - link to get next results (if available)
• limit - currently used limit

Example GET https://api.omnisend.com/v3/contacts?status=unsubscribed&limit=10:

{
  "contacts":[],
  "paging": {
    "previous": null,
    "next": "https://api.omnisend.com/v3/contacts?after=cRcZZU3g1j8heELm1uN8DVJqB1j&status=unsubscribed",
    "limit": 10
  }
}

To get next page, just use link in next: GET https://api.omnisend.com/v3/contacts?after=cRcZZU3g1j8heELm1uN8DVJqB1j&status=unsubscribed