Fetch list contents

Endpoint

Endpoint	request type	API Type
`https://{{Swym> API Endpoint }}/api/v3/lists/fetch-list-with-contents`	POST	shopper

Query Params

Parameter	Type	Required	Description
pid	string (Encoded)	Yes	Unique identifier for the store available in Swym Admin
limit	int64	No	Maximum number of records to return
offset	int64	No	Number of records to skip

Form Data

Field	Type	Required	Description
regid	string	Yes	Unique identifier for the shopper generated by generate-regid
sessionid	string	Yes	Session id generated with generate-regId endpoint which does not expire without manual intervention
lid	string	yes	Unique identifier of the list
excludeArchived	boolean	optional	excludes archived lists

Example Curl

curl --location --request POST '{{Swym API Endpoint}}/api/v3/lists/fetch-list-with-contents?pid={{Url Encoded PID}}' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Accept: application/json' \
--data-urlencode 'regid={{regid}}' \
--data-urlencode 'sessionid={{sessionid}}' \
--data-urlencode 'lid={{lid}}'

🚧
Curl Placeholders
Assuming these values are provided above, the curl command should work correctly. However, if there are any issues with the API endpoint or the data being passed in the request, there could still be errors that need to be resolved before you can test these APIS.

Placeholders	Descriptions
{{Swym API Endpoint}}	This needs to be replaced with the actual Swym API endpoint URL.
{{URL Encoded PID}}	This needs to be replaced with the actual PID value, URL-encoded.
{{regid}}	This needs to be replaced with the actual regid value.
{{sessionid}}	This needs to be replaced with the actual session ID value.
{{lid}}	This needs to be replaced with the actual list ID value.

Success Response

{
   "list":{
      "di":"f03daefc-d03e-438b-950c-86bdee5fcc6c",
      "listcontents":[
         {
            "dt":"Blue Silk Tuxedo",
            "empi":7168987889824,
            "lid":"94dff98c-3eaa-48ee-ad87-98af2f87aeb5",
            "du":"https://yourstore.myshopify.com/products/blue-silk-tuxedo?variant=41450466377888",
            "pid":"6cLXc3z0TERBWpFvFJUpxjaWITbnZ2/uBEzdkDw3lbo=",
            "epi":41450466377888,
            "id":"e90a7375-c0e4-477e-8a73-75c0e4177e0d",
            "uts":1682523571207,
            "_pkey":"Xjg/Jbh9",
            "iu":"https://cdn.shopify.com/s/files/1/0590/0723/8304/products/man-adjusts-blue-tuxedo-bowtie_925x_e6ca7031-3707-4ca0-9b1a-cfe7df185ebc_620x620.jpg?v=1638894844",
            "_t":2,
            "pr":70.0
         },
      ],
      "userinfo":null,
      "lty":"wl",
      "uid":"Xjg/Jbh9Y/0OTIydKNmd5NZjoB7w6B++1/RFflqnPa8=",
      "cts":1682520364996,
      "cnt":2,
      "lnote":"I am newly updated.",
      "lname":"My Wishlist",
      "lid":"94dff98c-3eaa-48ee-ad87-98af2f87aeb5",
      "pid":"/uBEzdkDw3lbo=",
      "st":1,
      "id":"75c32443-ecd5-442f-8324-43ecd5f42f1e",
      "canEdit":true,
      "uts":1682520590149,
      "_pkey":"Xjg/Jbh9",
      "_t":1,
      "itemcmnts":0,
      "lhash":"bXktd2lzaGxpc3Q=",
   },
   "items":[
      {
         "dt":"Blue Silk Tuxedo",
         "empi":7168987889824,
         "lid":"94dff98c-3eaa-48ee-ad87-98af2f87aeb5",
         "du":"https://yourstore.myshopify.com/products/blue-silk-tuxedo?variant=41450466377888",
         "pid":"/uBEzdkDw3lbo=",
         "epi":41450466377888,
         "id":"e90a7375-c0e4-477e-8a73-75c0e4177e0d",
         "uts":1682523571207,
         "_pkey":"Xjg/Jbh9",
         "iu":"https://cdn.shopify.com/s/files/1/0590/0723/8304/products/man-adjusts-blue-tuxedo-bowtie_925x_e6ca7031-3707-4ca0-9b1a-cfe7df185ebc_620x620.jpg?v=1638894844",
         "_t":2,
         "pr":70.0
      },
      {
         "di":"f03daefc-d03e-438b-950c-86bdee5fcc6c",
         "uid":"Xjg/Jbh9Y/0OTIydKNmd5NZjoB7w6B++1/RFflqnPa8=",
         "dt":"Black Leather Bag",
         "cts":1682520365028,
         "empi":7168987529376,
         "lid":"94dff98c-3eaa-48ee-ad87-98af2f87aeb5",
         "du":"https://yourstore.myshopify.com/products/black-leather-bag?variant=41450466017440",
         "pid":"/uBEzdkDw3lbo=",
         "epi":41450466017440,
         "id":"64beebf5-ceb5-4b47-beeb-f5ceb55b47f3",
         "uts":1682520365028,
         "_pkey":"Xjg/Jbh9",
         "iu":"https://cdn.shopify.com/s/files/1/0590/0723/8304/products/black-bag-over-the-shoulder_925x_f7b24271-3c83-4bc4-8968-5d1f6b5c2584_620x620.jpg?v=1638894832",
         "_t":2,
         "pr":30.0
      }
   ]
}

{
   "list":{
      "di":"f03daefc-d03e-438b-950c-86bdee5fcc6c",
      "listcontents":[
         {
            "dt":"Blue Silk Tuxedo",
            "empi":7168987889824,
            "lid":"94dff98c-3eaa-48ee-ad87-98af2f87aeb5",
            "du":"https://yourstore.myshopify.com/products/blue-silk-tuxedo?variant=41450466377888",
            "pid":"6cLXc3z0TERBWpFvFJUpxjaWITbnZ2/uBEzdkDw3lbo=",
            "epi":41450466377888,
            "id":"e90a7375-c0e4-477e-8a73-75c0e4177e0d",
            "uts":1682523571207,
            "_pkey":"Xjg/Jbh9",
            "iu":"https://cdn.shopify.com/s/files/1/0590/0723/8304/products/man-adjusts-blue-tuxedo-bowtie_925x_e6ca7031-3707-4ca0-9b1a-cfe7df185ebc_620x620.jpg?v=1638894844",
            "_t":2,
            "uby":"[email protected]",
            "pr":70.0
         },
      ],
      "userinfo":{
         "fname":"support",
         "sw_mkt":null,
         "uid":"Xjg/Jbh9Y/0OTIydKNmd5NZjoB7w6B++1/RFflqnPa8=",
         "m":null,
         "em":"[email protected]",
         "cts":1643656974342,
         "lname":"Swymcorp",
         "pid":"6cLXc3z0TERBWpFvFJUpxjaWITbnZ2/uBEzdkDw3lbo=",
         "uts":1682516274533,
         "acc_mkt":false,
         "ut":null,
         "prefs":{
            "Mediums":{
               "email":{
                  "signuptime":1643656974312,
                  "acceptmarketing":false,
                  "acceptsource":"shopify"
               }
            }
         }
      },
      "lty":"wl",
      "uid":"Xjg/Jbh9Y/0OTIydKNmd5NZjoB7w6B++1/RFflqnPa8=",
      "cts":1682520364996,
      "cnt":2,
      "lnote":"I am newly updated.",
      "lname":"My Wishlist",
      "cby":"[email protected]",
      "lid":"94dff98c-3eaa-48ee-ad87-98af2f87aeb5",
      "pid":"/uBEzdkDw3lbo=",
      "st":1,
      "id":"75c32443-ecd5-442f-8324-43ecd5f42f1e",
      "canEdit":true,
      "uts":1682520590149,
      "_pkey":"Xjg/Jbh9",
      "_t":1,
      "itemcmnts":0,
      "uby":"[email protected]",
      "lhash":"bXktd2lzaGxpc3Q=",
      "cfor":"[email protected]"
   },
   "items":[
      {
         "dt":"Blue Silk Tuxedo",
         "empi":7168987889824,
         "lid":"94dff98c-3eaa-48ee-ad87-98af2f87aeb5",
         "du":"https://yourstore.myshopify.com/products/blue-silk-tuxedo?variant=41450466377888",
         "pid":"/uBEzdkDw3lbo=",
         "epi":41450466377888,
         "id":"e90a7375-c0e4-477e-8a73-75c0e4177e0d",
         "uts":1682523571207,
         "_pkey":"Xjg/Jbh9",
         "iu":"https://cdn.shopify.com/s/files/1/0590/0723/8304/products/man-adjusts-blue-tuxedo-bowtie_925x_e6ca7031-3707-4ca0-9b1a-cfe7df185ebc_620x620.jpg?v=1638894844",
         "_t":2,
         "uby":"[email protected]",
         "pr":70.0
      },
      {
         "di":"f03daefc-d03e-438b-950c-86bdee5fcc6c",
         "uid":"Xjg/Jbh9Y/0OTIydKNmd5NZjoB7w6B++1/RFflqnPa8=",
         "dt":"Black Leather Bag",
         "cts":1682520365028,
         "empi":7168987529376,
         "cby":"[email protected]",
         "lid":"94dff98c-3eaa-48ee-ad87-98af2f87aeb5",
         "du":"https://yourstore.myshopify.com/products/black-leather-bag?variant=41450466017440",
         "pid":"/uBEzdkDw3lbo=",
         "epi":41450466017440,
         "id":"64beebf5-ceb5-4b47-beeb-f5ceb55b47f3",
         "uts":1682520365028,
         "_pkey":"Xjg/Jbh9",
         "iu":"https://cdn.shopify.com/s/files/1/0590/0723/8304/products/black-bag-over-the-shoulder_925x_f7b24271-3c83-4bc4-8968-5d1f6b5c2584_620x620.jpg?v=1638894832",
         "_t":2,
         "uby":"[email protected]",
         "pr":30.0
      }
   ]
}

Error Status Codes:

If the request is unsuccessful, the API will return a JSON response with an error message and an HTTP status code indicating the type of error that occurred.

Status Code	Type	Description
400	Bad Request	Your request is invalid, change your request params and query and try again.
401	Unauthorised	You are performing an action on a resource that is not granted to the current logged-in user. Additionally, for REST APIs, this could mean your API key is wrong.
403	Forbidden	You are not allowed to request this data.
404	Not Found	The specified requested data could not be found.
429	Too Many Requests	You're raising too many requests! Slow down!
500	Internal Server Error --	We had a problem with our server. Try again later.
503	Service Unavailable	We're temporarily offline for maintenance. Please try again later.