Move to Cart [Beta]

Move items to cart from Save for Later list

🚧

Contact support for using Save for Later Beta APIs.

Endpointrequest typeAPI Type
https://{{Swym API Endpoint }}/api/v3/lists/sfl/moved-to-cartPOSTshopper

Query Params

ParameterTypeRequiredDescription
pidstring (Encoded)YesUnique identifier for the store available in Swym Admin

Form Data

FieldTypeRequiredDescription
regidstringYesUnique identifier for the shopper generated by generate-regid
sessionidstringYesSession id generated with generate-regId endpoint which does not expire without manual intervention
lidstringYesUnique identifier of the save for later list.
user-agentstringYesUser-Agent header of the app used to access the API
itemsArray of list itemsYesArray of products to add to the list.

Example Curl


curl -X POST '{{Swym API Endpoint}}/api/v3/lists/sfl/moved-to-cart?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}}' \ 
     --data-urlencode 'user-agent={{user-agent}}'\
     --data-urlencode 'items=[{"epi":41450466377888,"empi":7168987889824,"du":"https://yourstore.myshopify.com/products/blue-silk-tuxedo"}]'


🚧

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.

PlaceholdersDescriptions
{{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 save for later list ID value.
{{user-agent}}This needs to be replaced with User-Agent header value.

Success Response

{
  "itemsmoved": [
    {
      "di": "27e0ff4a-e950-4057-aab0-e62fa0821c83",
      "bt": "Snowboard Vendor",
      "clbls": [],
      "uid": "eQfca8LNr0PeDPyEIb7Bz97FxkYqwbhcKMGVT5/rSHQ=",
      "dt": "The Complete Snowboard",
      "cts": 1699666952862,
      "empi": 7168987889824,
      "cby": "[email protected]",
      "lid": "0b2c578f-7583-4175-b0fe-db5fc31f4b7c",
      "du": "https://yourstore.myshopify.com/products/blue-silk-tuxedo",
      "pid": "C7vi6wI9s9aa0jE3DY+e2J8R/45MnnDtXYF6xfGNlDQ=",
      "epi": 41450466377888,
      "cprops": {},
      "uts": 1699666952862,
      "iu": "https://cdn.shopify.com/s/files/1/0843/0927/8998/products/Main_589fc064-24a2-4236-9eaf-13b2bd35d21d_620x620.jpg?v=1699407350",
      "qty": 1,
      "uby": "[email protected]",
      "pr": 699.95,
      "vi": "Ice"
    }
  ],
  "itemsfailed": []
}

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 CodeTypeDescription
400Bad RequestYour request is invalid, change your request params and query and try again.
401UnauthorisedYou 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.
403ForbiddenYou are not allowed to request this data.
404Not FoundThe specified requested data could not be found.
500Internal Server ErrorWe had a problem with our server. Try again later.
503Service UnavailableWe're temporarily offline for maintenance. Please try again later.

Product

An object containing params required for creating, updating or deleting list items

Property NameData TypeRequiredDescription
epiint/stringYesVariant id of the product to be added
empiint/stringYesProduct id of the product to be added
dustringYesCanonical uri of the product to be added
qtyintoptionalDefaults to 1. Quantity included for the add action
notestringoptionalOptional note
cpropsobjectoptionalMap of custom fields
clblsarrayoptionalArray of strings indicating labels, rooms, etc. for HTC. Only one value supported in array. eg: ["Room1"]