---
title: "Move cart items to the wishlist"
method: POST
path: "/move-to-wishlists"
tags: ["Cart"]
---

# Move cart items to the wishlist

`POST /move-to-wishlists`

## Request

- Base URL: `http://localhost:8000/api/shop`
- URL: `http://localhost:8000/api/shop/move-to-wishlists`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/bagisto/apis/bagisto-shop-api/docs/move-to-wishlists/post.ts> (a function with typed inputs; its response is checked against the schema)

Moves cart items of the Bearer token cart into the wishlist of the customer and removes them from the cart. Requires a customer login. `quantities` matches `itemIds` by position and defaults to 1.

## Headers

- `X-STOREFRONT-KEY` string, required
- `X-Locale` string
- `X-Channel` string
- `X-Currency` string

## Request body

- object
  - `itemIds` integer[], required
  - `quantities` integer[]

## Response `201`

Returns the full cart.

- MoveToWishlistCartDataMutation: MoveToWishlist - GraphQL API Resource for Moving Items to Wishlist Provides mutation for moving multiple items from cart to wishlist.
  - `id` integer, nullable
  - `cartToken` string, nullable: Cart token for guest users
  - `customerId` integer, nullable
  - `channelId` integer, nullable
  - `itemsCount` integer, nullable
  - `items` CartItemDataMutation[]: Individual cart items
    - `id` integer, nullable
    - `cartId` integer, nullable
    - `productId` integer, nullable
    - `name` string, nullable
    - `sku` string, nullable
    - `quantity` integer, nullable
    - `price` number, nullable
    - `basePrice` number, nullable
    - `total` number, nullable
    - `baseTotal` number, nullable
    - `discountAmount` number, nullable
    - `baseDiscountAmount` number, nullable
    - `taxAmount` number, nullable
    - `baseTaxAmount` number, nullable
    - `options` unknown[], nullable
      - unknown
    - `type` string, nullable
    - `formattedPrice` string, nullable
    - `formattedTotal` string, nullable
    - `priceInclTax` number, nullable
    - `basePriceInclTax` number, nullable
    - `formattedPriceInclTax` string, nullable
    - `totalInclTax` number, nullable
    - `baseTotalInclTax` number, nullable
    - `formattedTotalInclTax` string, nullable
    - `baseImage` string, nullable
    - `productUrlKey` string, nullable
    - `canChangeQty` boolean, nullable
  - `subtotal` number, nullable: Subtotal before discounts and taxes
  - `baseSubtotal` number, nullable
  - `discountAmount` number, nullable: Total discount amount
  - `baseDiscountAmount` number, nullable
  - `taxAmount` number, nullable: Total tax amount
  - `baseTaxAmount` number, nullable
  - `shippingAmount` number, nullable: Shipping cost
  - `baseShippingAmount` number, nullable
  - `grandTotal` number, nullable: Grand total
  - `baseGrandTotal` number, nullable
  - `formattedSubtotal` string, nullable: Formatted subtotal price
  - `formattedDiscountAmount` string, nullable: Formatted discount amount
  - `formattedTaxAmount` string, nullable: Formatted tax amount
  - `formattedShippingAmount` string, nullable: Formatted shipping amount
  - `formattedGrandTotal` string, nullable: Formatted grand total price
  - `couponCode` string, nullable: Applied coupon code
  - `miniCartOfferInfoEnabled` boolean, nullable: Whether to show the mini cart offer: the mini cart is switched on and an offer text is set (Sales > Checkout > Mini Cart)
  - `miniCartOfferInfo` string, nullable: The mini cart offer text for the requested channel and locale (Sales > Checkout > Mini Cart > Offer Info)
  - `shippingMethods` object[], nullable: Shipping methods available for the estimate address. Returned by estimate shipping only.
  - `success` boolean, nullable
  - `message` string, nullable
  - `carts` unknown[], nullable
    - unknown
  - `sessionToken` string, nullable: Unique session token for guest cart
  - `isGuest` boolean: Is this a guest cart
  - `itemsQty` integer, nullable: Total quantity of all items
  - `subTotalInclTax` number, nullable: Subtotal including tax
  - `baseSubTotalInclTax` number, nullable: Base subtotal including tax
  - `formattedSubTotalInclTax` string, nullable: Formatted subtotal including tax
  - `taxTotal` number, nullable: Tax total
  - `formattedTaxTotal` string, nullable: Formatted tax total
  - `shippingAmountInclTax` number, nullable: Shipping amount including tax
  - `baseShippingAmountInclTax` number, nullable: Base shipping amount including tax
  - `formattedShippingAmountInclTax` string, nullable: Formatted shipping amount including tax
  - `billingAddress` unknown[], nullable: Billing address
    - unknown
  - `shippingAddress` unknown[], nullable: Shipping address
    - unknown
  - `appliedTaxes` unknown[], nullable: Applied taxes
    - unknown
  - `haveStockableItems` boolean, nullable: Has stockable items
  - `paymentMethod` string, nullable: Payment method code
  - `paymentMethodTitle` string, nullable: Payment method title
  - `selectedShippingRate` string, nullable: Selected shipping rate
  - `selectedShippingRateTitle` string, nullable: Selected shipping rate title
  - `paymentRedirectUrl` string, nullable: Payment redirect URL (if payment gateway redirect needed)
  - `orderId` string, nullable: Order ID after order creation
  - `redirectUri` string, nullable: Redirect URL for buy now checkout
  - `redirect` boolean, nullable: True when the selected payment method requires the shopper to be sent to a payment page before the order is created
  - `redirectUrl` string, nullable: Redirect URL for payment gateway
  - `orderIncrementId` string, nullable: Order ID after successful order creation

## Other responses

- `400`: Missing or invalid input.
- `404`: Cart not found for the Bearer token.
- `422`: Validation Error

## Changes

- **2026-10-28** `52d9bb5c7a63`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bagisto/apis/bagisto-shop-api/changes/move-to-wishlists/post.md)

---

[API](https://skmtc.dev/bagisto/apis/bagisto-shop-api.md) - [All operations](https://skmtc.dev/bagisto/apis/bagisto-shop-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bagisto/apis/bagisto-shop-api/revisions/f619df36bf29?raw)