List Carts

Retrieves a list of abandoned carts for a given store.
Each entry in the list provides a brief overview of the abandoned cart,
including essential details such as the cart ID, customer information, total value, and a unique URL for retargeting.

Abandoned carts are identified when a user adds products to their online shopping cart but
does not proceed to checkout and complete the purchase within 10 minutes of inactivity.

For retargeting purposes, each abandoned cart object includes a url field, which is the direct link
to the specific abandoned cart. This URL, along with customer name and contact details provided in the response,
facilitates effective retargeting strategies by merchants.

You can filter the list by date, phase, and the total number of carts.

For a detailed view of a specific cart, including product details
and additional customer information, refer to the
Get Abandoned Cart Details
endpoint using the cart's unique ID.

🔑Scopes

abandoned_carts.read - Abandoned Carts Read

curl --location 'https://api.zid.sa/v1/managers/store/abandoned-carts?page=1&page_size=15&phase=undefined&search_term=undefined&customer_id=undefined&products_count=undefined&has_reminders=undefined&country_id=undefined&city_id=undefined&currency_code=undefined&date_from=undefined&date_to=undefined&cart_total=undefined&filter_order_by=created_at&filter_sort_by=undefined&customer_type=undefined' \ --header 'Authorization: {{Autherization}}' \ --header 'X-Manager-Token: {{Access-Token}}' \ --header 'Accept-Language: en'

{ "status": "object", "abandoned-carts": [ { "id": "b978fcc2-ccd0-45f6-81a7-7ab1f3b8f85d", "store_id": "d297fb8b-c322-412e-a2f4-ffa96dc57022", "session_id": "3:694ff0d8df6032a7697a3849", "url": "https://osama.zid.store/checkout/fromBasket/3:694ff0d8df6032a7697a3849", "cart_id": "3:694ff0d8df6032a7697a3849", "order_id": null, "phase": "payment_method", "customer_id": 15141670, "customer_name": "mahmoud aaaa", "customer_email": "a.alkallas@zid.sa", "customer_mobile": "966500000005", "city_id": 5354, "products_count": 1, "reminders_count": 2, "cart_total": 509.8254, "cart_total_string": "509.83 ج.م", "whatsapp_message": "Hello What'sapp", "currency_code": "EGP", "created_at": "2025-12-27T14:45:44.000000Z", "updated_at": "2025-12-28T14:53:39.000000Z", "source": "catalog" }, { "id": "88537913-f12a-468b-8b03-5a10ada7eb3d", "store_id": "d297fb8b-c322-412e-a2f4-ffa96dc57022", "session_id": "3:69473e9254de8076e8311e0c", "url": "https://osama.zid.store/checkout/fromBasket/3:69473e9254de8076e8311e0c", "cart_id": "3:69473e9254de8076e8311e0c", "order_id": null, "phase": "payment_method", "customer_id": 15141670, "customer_name": "mahmoud aaaa", "customer_email": "test@zid.sa", "customer_mobile": "966500000005", "city_id": 1, "products_count": 1, "reminders_count": 4, "cart_total": 13.35, "cart_total_string": "13.35 SAR", "whatsapp_message": "Hello What'sapp", "currency_code": "SAR", "created_at": "2025-12-21T00:26:39.000000Z", "updated_at": "2025-12-22T00:37:53.000000Z", "source": "catalog" } ], "pagination": { "page": 1, "page_size": 2, "next_page": 2, "last_page": 243, "result_count": 485 }, "message": { "type": "object", "code": null, "name": null, "description": null } }

Request

Responses