Gift Wishlist

Creates a checkout from line items and/or a cart. Nothing is charged: the checkout is a 'Review and pay' page on supraise.com (continue_url) where the user adds an address and pays. Returns continue_url, a summary (subtotal and estimated_total, both with the Supraise service fee already in the item prices; tax and shipping are added once the retailer prices the order) and messages: address_required, cannot_ship_to_address, split_orders (items from several sellers become separate orders), price_unknown, over_limit (orders are capped at €200 ($217) for now). The checkout stays open 30 days.

create_checkout

Creates a wishlist of products from search_catalog, with a title (e.g. 'Birthday 2026') and optional notes per item. Returns share_url: a public page on supraise.com where friends and family see the items, open each product to buy it as a gift, and mark it bought so nobody buys it twice. With surprise: true the owner does not see which items were bought.

create_wishlist

Returns the signed-in user's Supraise account: saved shipping addresses (from past checkouts and gift recipients), gift wallet balance, gift plans and saved payment methods.

get_account

Returns a checkout's status (open; paid = paid, test orders; completed = paid and ordered; expired), lines, totals, messages, continue_url and, once paid, the order ids.

get_checkout

Returns one product with its options (e.g. Size, Width, Color) and all variants. Given `options` as name/label pairs, selected_variant is the matching variant and its variant_id; when nothing matches, selected_variant is null and the available values are listed in options.

get_product

Lists the user's wishlists, newest first, with their items, notes and share_url. Unless surprise is on, each item says whether a friend has marked it bought.

get_wishlists

Returns products already found by search_catalog, by id, without a new search. Unknown ids are listed in not_found.

lookup_catalog

Searches products across Amazon, Walmart, Target, Best Buy, Home Depot and other US retailers in one call, for finding, comparing or buying a product. Returns up to `limit` products, each with title, rating, review count, a one-line summary, image_url, the price from each seller, and product_url (the product's Supraise page, where options are chosen and the purchase is made). Results are also shown as product cards with images. Prices are in USD and already include the Supraise service fee; tax and shipping are added when the retailer prices the order.

search_catalog

Adds products to a wishlist (or changes their note), removes products by id, renames it or turns surprise on or off. Returns the updated wishlist and its share_url.

update_wishlist