Fetch Paginated List

swat.wishlist.fetchPaginatedList

Returns an array of paginated ListContents (products) for the List with a given listData.

Used to fetch the paginated List Contents present in a given List.

Definition

swat.wishlist.fetchPaginatedList(listData, onSuccess, onError)

Example

Here's an example of how you can use this API to fetch the paginated List Contents of a List called My Wishlist:

// Define the listData object  
let listData = {  
  sortby: "price", // column name to sort the list items
  sortorder: "asc", // sort order to sort the list items
  filterby: "outofstock", // filter condition to filter list items
  lid: "0116e283-ed9a-4685-adf1-68eea1751f62", // lid
  itemslimit: 60, // limit of items returned in one page
  next: "idnVDP9ygHcFgmReBhsE5afJQ0Q-2nxI_puRMqptxdJld5Nha74urvqgx1B1AijiRU9bACEo2cA1Rct1MQvUxczkUSfVKJeF9NeuUS5uAo-WnPLAVmd07my5s4xlh7JPX2d_8akl6PS_mdfdVBQh8YX2crfRTtN3NOqPNrvTTDsODRvUn3CUW9vWqZNmq5OGzQcllC0omfa7vBCb9Byiq-64s5ZjYdqJHyeYSrOCK2a4l2jLVxdKAbfFaj6E7oJy"
  // next token to fetch the next page. The next token will be null in the first request
};

// Define success callback  
let onSuccess = function(data) {  
  // Executed when a paginated list data is successfully fetched  
  console.log("Successfully fetched paginated list data of the shopper: ", data);  
}

// Define error callback  
let onError = function(error) {  
  console.log("Error while fetching paginated list data", error);  
}

// Fetch the paginated list data of the shopper
swat.wishlist.fetchPaginatedList(listData, onSuccess, onError);

📘
Sort and Filter
Please note that sort and filter are not enabled by default and are only available for the Enterprise plan. If you need to sort and filter, please contact the support team to enable it.

API Parameters

Argument	Type	Description
listData	`object`	Data about the list which may include `lid`, `sortby`, `sortorder`, `filterby`, `itemslimit` and `next`.
onSuccess	`function`	Called when the List Contents are successfully fetched.
onError	`function`	Called when there is an error while fetching the List Contents.

Success Response

The success response contains an array of List Contents present in the given List and the next token in the pagination object. Each List Item has information like its empi, epi, quantity etc.

{
    "status": "success",
    "data": {
        "di": "96f35dcb-699d-46ca-ad09-6f9503ca3275",
        "listcontents": [
            {
                "di": "96f35dcb-699d-46ca-ad09-6f9503ca3275",
                "uid": "k6EjhHmacSbNDQW/9ZM24umd2pV5VLUDe44sNcfSunM=",
                "dt": "Axium 100 B83",
                "cts": 1692122982864,
                "empi": 8571187331353,
                "cby": "[email protected]",
                "lid": "1e086691-b88a-48df-9cac-fa7da8c57827",
                "du": "https://swym-ent-test-store.myshopify.com/products/rossignol-axium-100-b83",
                "pid": "jID7uqlAM3iF/xqAmtL8eFr0kC7nvE/NDXyrLxZ1Y6E=",
                "epi": 46323696369945,
                "id": "974a0281-6ba0-4562-8a02-816ba0b56273",
                "uts": 1692122982864,
                "_pkey": "k6EjhHma",
                "iu": "https://swym-ent-test-store.myshopify.com/cdn/shop/products/rossignol_RCDA029_AXIUM-100-B83-BLACK-WHITE_620x620.jpg?v=1692122914",
                "_t": 2,
                "uby": "[email protected]",
                "pr": 110,
                "ct": "Ski Bindings",
                "vi": "B83 Black/White"
            }
        ],
        "lty": "wl",
        "uid": "k6EjhHmacSbNDQW/9ZM24umd2pV5VLUDe44sNcfSunM=",
        "cts": 1692122947783,
        "lname": "My Wishlist",
        "cby": "[email protected]",
        "lid": "1e086691-b88a-48df-9cac-fa7da8c57827",
        "pid": "jID7uqlAM3iF/xqAmtL8eFr0kC7nvE/NDXyrLxZ1Y6E=",
        "st": 1,
        "id": "965d94ac-6927-40ea-9d94-ac692730ea9a",
        "uts": 1692122947783,
        "_pkey": "k6EjhHma",
        "_t": 1,
        "uby": "[email protected]",
        "lhash": "bXktd2lzaGxpc3Q=",
        "cfor": "[email protected]"
    },
    "pagination": {
        "next": "4VmfPRKJ_Ag9zCAWRLL9bYXi1ZFMe33oNkdkDDGvSJ_CzHbLTl4wWSl6wVttEk7b5MJ_oiKd8Yh6Q1CNzODvurorzhwh2-G4_57WCNNdbrmewWz-N_KejfYAa755pG2aDYDaH35gR2lqfKjBwl3HOJ7bFvkyOuDz-hcZl41rOc4b_anzI7Crf59BoU8facfJ"
    }
}

Other References

List Data

{  
  "sortby": "price", // column name to sort the list items
  "sortorder": "asc", // sort order to sort the list items
  "filterby": "outofstock", // filter condition to filter list items
  "lid": "0116e283-ed9a-4685-adf1-68eea1751f62", // lid
  "itemslimit": 60, // limit of items returned in one page
  "next": "idnVDP9ygHcFgmReBhsE5afJQ0Q-2nxI_puRMqptxdJld5Nha74urvqgx1B1AijiRU9bACEo2cA1Rct1MQvUxczkUSfVKJeF9NeuUS5uAo-WnPLAVmd07my5s4xlh7JPX2d_8akl6PS_mdfdVBQh8YX2crfRTtN3NOqPNrvTTDsODRvUn3CUW9vWqZNmq5OGzQcllC0omfa7vBCb9Byiq-64s5ZjYdqJHyeYSrOCK2a4l2jLVxdKAbfFaj6E7oJy"
  // next token to fetch the next page. The next token will be null in the first request
}

Argument	Type	required?	Description
lid	string	Yes	List id to identify the list uniquely.
sortby	string (`price`/`title`)	(optional)	Disabled by default. Please Contact Support to enable. Column to use for sorting the list contents. Should be one of `price` or `title`. By default, the list is sorted using the time items were added to the list.
sortorder	string (`asc`/`desc`)	(optional)	Disabled by default. Please Contact Support to enable. Sort the list contents in ascending or descending order. Should be one of `asc` or `desc`. By default, the list is sorted in descending order.
filterby	string (`instock`/`outofstock`)	(optional)	Disabled by default. Please Contact Support to enable. Apply filter by conditions to the items. `instock` is to fetch items that are currently in stock and `outofstock` is to fetch items that are currently out of stock. Should be one of `instock` or `outofstock`. By default, no filter by conditions is applied.
itemslimit	int	(optional)	Number of items to be returned in a page. The minimum value is 50 and the Maximum value is 100. The default value if not passed is 50. To update the default value permanently, please contact support.
next	string	(optional)	Next Token for fetching the next page. If not provided, the first page will be fetched. This token is reset if any of the sort or filter params are updated. The next token to fetch the next page is provided in the response of a successful API call. If the next token is null, then the list has reached the end and has no next page.