Skip to main content

getWishlist

Get the current user's or guest's wishlist. 🔐 This method requires authorization (or a guest context).

Description​

This method returns the wishlist of the current context - an authorized user or a guest (resolved via the x-guest-id header, see Guest mode). It returns a Promise that resolves to an IWishlistResponse object.

Users.getWishlist(

);

Examples​

Minimal example​

const response = await Users.getWishlist();

Example response​

{
  "items": [
    {
      "productId": 1,
      "addedAt": "2026-05-30T10:00:00.000Z"
    }
  ],
  "total": 1
}

Response schema​

Schema: IWishlistResponse

items: IWishlistItem[]
Wishlist items.

items.productId: number
Product identifier.
example: 1

items.addedAt: string
ISO date when the item was added.
example: "2026-05-30T10:00:00.000Z"

total: number
Total number of items in the wishlist.
example: 3