Wishlists
Customer favourite products
Returns the customer's favourite products with merchandising metadata.
Page number (1-indexed)
1Number of results per page
20Filter favourites by product identifier (repeatable)
Filter favourites by exact product identifier
9876Filter favourites by product base codes (comma separated)
ABC123,XYZ999Filter favourites by product name (case insensitive contains)
smartwatchSession cookie header (e.g. sessionid=abc123)
Favourite products listed
5https://sandbox.akinon.com/wishlists/favourite-products/?page=2Authentication required
GET /wishlists/favourite-products/ HTTP/1.1
Host: sandbox.akinon.com
X-Cookie: text
Accept: */*
{
"count": 5,
"next": "https://sandbox.akinon.com/wishlists/favourite-products/?page=2",
"previous": null,
"results": [
{
"pk": 42,
"product": {
"pk": 221133,
"name": "Smart Watch X",
"sku": "SW-X-BLACK",
"base_code": "SWX",
"price": "1999.00",
"retail_price": "2499.00",
"currency_type": "TRY",
"in_stock": true,
"stock": 12,
"absolute_url": "https://sandbox.akinon.com/product/smart-watch-x/",
"productimage_set": [
{
"pk": 4455,
"image": "https://cdn.akinon.com/images/products/smart-watch-x.png",
"order": null,
"specialimage_set": [
{
"ANY_ADDITIONAL_PROPERTY": "anything"
}
]
}
],
"productvideo_set": [
{
"pk": 1,
"video": "https://example.com"
}
],
"is_ready_to_basket": true,
"extra_data": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"basket_offers": [
{
"ANY_ADDITIONAL_PROPERTY": "anything"
}
],
"price_type": "default",
"tax_rate": "18.00",
"price_extra_field": {
"ANY_ADDITIONAL_PROPERTY": "anything"
}
}
}
]
}Stores the given product in the authenticated shopper's favourites.
Session cookie header (e.g. sessionid=abc123)
Product identifier to favourite
221133Favourite created
Favourite product entry
42Request payload validation error
Authentication required
Product already exists in favourites
POST /wishlists/favourite-products/ HTTP/1.1
Host: sandbox.akinon.com
X-Cookie: text
Content-Type: application/json
Accept: */*
Content-Length: 18
{
"product": 221133
}{
"pk": 42,
"product": {
"pk": 221133,
"name": "Smart Watch X",
"sku": "SW-X-BLACK",
"base_code": "SWX",
"price": "1999.00",
"retail_price": "2499.00",
"currency_type": "TRY",
"in_stock": true,
"stock": 12,
"absolute_url": "https://sandbox.akinon.com/product/smart-watch-x/",
"productimage_set": [
{
"pk": 4455,
"image": "https://cdn.akinon.com/images/products/smart-watch-x.png",
"order": null,
"specialimage_set": [
{
"ANY_ADDITIONAL_PROPERTY": "anything"
}
]
}
],
"productvideo_set": [
{
"pk": 1,
"video": "https://example.com"
}
],
"is_ready_to_basket": true,
"extra_data": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"basket_offers": [
{
"ANY_ADDITIONAL_PROPERTY": "anything"
}
],
"price_type": "default",
"tax_rate": "18.00",
"price_extra_field": {
"ANY_ADDITIONAL_PROPERTY": "anything"
}
}
}Lightweight favourite check for product listing pages. Given a set of repeatable product_id query parameters, returns the ones favourited by the authenticated shopper, each paired with the wishlist item id (favourite_id) required to remove it from favourites via deleteFavouriteProduct.
Unlike listFavouriteProducts, this endpoint performs a single database query and returns only identifiers — no product cards, pricing, stock, or media are serialized. It is intended for storefront listing / infinite-scroll views that need to render the "favourited" state of many products at once (and offer a remove action) without the cost of the full favourites payload.
Behaviour notes:
Invalid (non-integer)
product_idvalues are silently ignored.When no valid
product_idis supplied, an empty list is returned.When SKU-level favourites are disabled (
FAVOURITE_SKU_IS_ACTIVE=false), a product is reported as favourited if the shopper has favourited any product sharing itsbase_code, andfavourite_idpoints at that existing base_code favourite.
Product identifiers to check for favourited state (repeatable)
[600993,78179,853075]Session cookie header (e.g. sessionid=abc123)
Favourited products resolved
Favourited entries among the queried products. Each entry pairs the
queried product_id with the wishlist item id (favourite_id) needed
to remove it from favourites via deleteFavouriteProduct.
Authentication required
GET /wishlists/favourite-product-ids/ HTTP/1.1
Host: sandbox.akinon.com
X-Cookie: text
Accept: */*
{
"favourite_products": [
{
"product_id": 600993,
"favourite_id": 42
}
]
}Favourite identifier
Session cookie header (e.g. sessionid=abc123)
Favourite removed
No content
Authentication required
Favourite not found
DELETE /wishlists/favourite-products/{pk}/ HTTP/1.1
Host: sandbox.akinon.com
X-Cookie: text
Accept: */*
No content
Last updated
Was this helpful?

