Zid Docs
Apps
ThemesPayments
Apps
ThemesPayments
Help Center
Slack
  1. Abandoned Carts
  • ๐Ÿ—‚๏ธ Overview
  • ๐Ÿš€ Start Here
  • Create your First App
  • Responses
  • Rate Limiting
  • Authorization
  • Embedded Apps
  • StoreFront Events
  • Zid MUI
  • Zid SDKs
  • Our custom MCP server
  • Merchant APIs
    • Account
      • Me
        • Me
        • Profile
      • Store
        • Store
        • Branding
        • Localization
        • Social
        • Operations
        • Business
        • Upload Logo Image
        • Delete Logo Image
        • Upload Icon Image
        • Delete Icon Image
        • Upload Cover Image
        • Delete Cover Image
    • Orders
      • Validate Order Request
      • Create Order
      • Change Order Status
      • Add Order Comment
      • View Order
      • List Orders
      • List Custom Order Statuses
      • List Order Credit Notes
    • Reverse Orders
      • Create Reverse Orders
      • Create Reverse Orders Waybill
      • Add Reverse Order Reasons
      • List Reverse Reasons
      • Calculate Reverse Totals
      • Create refund for reverse order
      • Upload bank transfer receipt
      • Update return products
      • Order Details โ€“ View for Return
    • Abandoned Carts
      • List Carts
        GET
      • View Cart
        GET
    • Products
      • Managing Products
        • Create Product Types
        • Create Product
        • List Products
        • View Product
        • List Product Settings
        • Update Product
        • Bulk Update Products
        • Delete Product
      • Digital Vouchers
        • List Vouchers
        • Order Vouchers
        • Create Voucher
        • Import Vouchers
        • Export Vouchers
        • Update Voucher
        • Remove Voucher
      • Product Categories
        • List Categories
        • View Category
        • Create Category
        • Create Subcategory
        • Update Category
        • Assign Product to Category
        • Bulk Assign Products to Category
        • Publish Category
        • Detach Category from All Products
        • Remove Product from Category
      • Product Badge
        • List Badges
      • Product Attributes
        • List Attributes
        • View Attribute
        • Create Attribute
        • Update Attribute
        • Delete Attribute
      • Product Attribute Presets
        • List Presets
        • Create Preset
        • Update Preset
        • Delete Preset
      • Product Variants
        • Create Variants
        • Create Custom Option
        • Update Custom Option
        • Delete Custom Option Field
        • Create Custom Input Field
        • Update Custom Input Field
        • Delete Custom Input Field
      • Product Sorting
        • Set Manual Product Order
        • Reset Manual Product Order
      • Product Images
        • List Images
        • Upload Image
        • Update Image Order
        • Delete Image
      • Product Availability Notifications
        • Notification Stats
        • Noticiation Settings
        • List Notifications
        • Create Notification
        • Update Settings
        • Send Notification Email
        • Export Notifications
      • Product Export
        • Email All Products to Store Owner
        • Import Products via CSV or xlsx File
      • Product Stock
        • Retrieve Product Stock
        • List Product Stock Records
        • Create Product Stock
        • Update Product Stock
        • Bulk Update Product Stock Records
      • Product Questions & Answers
        • Retrieve Product Question
        • Retrieve Product Answer
        • List Product Questions
        • List Answers for Question
        • Create Product Question
        • Create Product Answer
        • Update Product Question
        • Update Product Answer
        • Delete Product Question
        • Delete Product Answer
      • Product Reviews
        • List Reviews
        • Count Reviews
      • Digital Products
        • Create Downloadable Product
        • Generate Upload URL
        • Upload File to S3
        • Create Product Downloadable
        • Get Product Downloadables
        • Delete Product Downloadable
        • List Store Downloadables
        • Create Store Downloadable
        • Delete Store Downloadable
    • Inventories
      • Create Location
      • Update Location
      • Update Product Stock for Location
      • List Locations
      • View Location
    • Shipping
      • List Store Shipping Methods
    • Marketing
      • Coupons
        • List Coupons
        • View Coupon
        • Create Coupon
        • Generate Bulk Coupons
        • Duplicate Coupon
        • Duplicate Bulk Coupons
        • Update Coupon Note
        • Update Coupon
        • Update Bulk Coupons
        • Update Coupon Status
        • Update Bulk Coupons Status
        • Delete Coupon
        • Delete Bulk Coupons
      • Bundle Offers
        • List Bundle Offers
      • Loyalty Program
        • Loyalty Program Status
        • Loyalty Program Details
        • Loyalty Program Info
        • Customer Loyalty Summary
        • Customer Points History
        • Activate Loyalty Program
        • Set Points Expiration Rules
        • Update Cashback Rule
        • Create Points Redemption Method
        • Update Points Redemption Method
        • Delete Points Redemption Method
        • Adjust Customer Points
      • Discount Rules
        • List Discount Rules
        • View Discount Rule
        • Create Discount Rule
        • Update Discount Rule
    • Customers
      • Customer Tags
        • List Customer Tags
        • Add Customer Tag
        • ู’Update Customer Tag
        • Delete Customer Tag
      • List Customers
      • View Customer
      • Primary Customer List
      • FInd Customer By Phone Number
      • Customer Profile
      • Add Customer
      • Update Customer
      • Delete Customer
      • Add Bulk Customers
      • Import Customers
    • Store Settings
      • ๐Ÿ“„ User Roles and Permissions
      • Retrieve Store Manager Profile
      • Retrieve VAT Settings
      • List Payment Methods
      • List Store Operating Countries
    • Countries and Cities
      • List Countries
      • List Cities for Country
  • Webhooks
    • Overview
    • Webhook Health Tracking
    • Events
      • Order
      • Product
      • Abandoned Cart
      • Customer
      • Product Category
    • APIs
      • Health Summary
      • Broken Webhooks
      • Recover Broken Webhooks
      • List Webhooks
      • Create Webhook
      • Delete Webhook
      • Delete Webhook By subscriber
  • App Management
    • Events
    • APIs
      • Subscription Details
      • Update Usage-Based Charges
  1. Abandoned Carts

View Cart

GET
https://api.zid.sa/v1/managers/store/abandoned-carts/{cart-id}
This endpoint fetches comprehensive details about an abandoned cart, identified
by its unique ID. An abandoned cart is a shopping cart to which items have been added
but is left incomplete by the customer. A cart is marked as abandoned after
10 minutes of inactivity.
Along with detailed information about the cart and its contents, this endpoint provides
the url field, which is the direct link to the abandoned cart. This enables merchants
to easily retarget customers with a direct link to their uncompleted purchase,
enhancing the chances of converting these abandoned carts into completed transactions.
The response also includes the customer's name and contact details, providing additional context
for retargeting efforts and potential follow-up communications.
The response conforms to the Abandoned Cart schema, providing comprehensive details
of the cart, its associated customer, and the products within it.
๐Ÿ”‘Scopes
abandoned_carts.read - Abandoned Carts Read

Request

Path Params

Header Params

Responses

๐ŸŸข200OK
application/json
Bodyapplication/json

๐ŸŸ 401Unauthorized
๐ŸŸ 422Validation errors
๐Ÿ”ด500Internal Server error
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.zid.sa/v1/managers/store/abandoned-carts/b978fcc2-ccd0-45f6-81a7-7ab1f3b8f85d' \
--header 'Authorization: {{Autherization}}' \
--header 'X-Manager-Token: {{Access-Token}}' \
--header 'Accept-Language: en'
Response Response Example
200 - Success
{
    "status": "object",
    "abandoned_cart": {
        "id": "b978fcc2-ccd0-45f6-81a7-7ab1f3b8f85d",
        "url": "https://osama.zid.store/checkout/fromBasket/3:694ff0d8df6032a7697a3849",
        "store_id": "d297fb8b-c322-412e-a2f4-ffa96dc57022",
        "store_name": "ู…ุชุฌุฑ ุฃุณุงู…ุฉ.",
        "store_logo": "https://media.zid.store/d297fb8b-c322-412e-a2f4-ffa96dc57022/0e959ed7-ced5-47df-b839-16969940db08-200x.jpg",
        "store_url": "https://osama.zid.store/",
        "products_count": 1,
        "products": [
            {
                "id": 1048562914,
                "product_id": "b2dd7116dd724f7fb10cac7e85b34655",
                "product_url": "https://osama.zid.store/products/b2dd7116dd724f7fb10cac7e85b34655",
                "sku": "Z.17639724523193033",
                "name": "Test recurring",
                "custom_field": [],
                "price": 38.0182984840272,
                "price_string": "38.02 ุฌ.ู…",
                "additions_price": 0,
                "additions_price_string": "0.00 ุฌ.ู…",
                "quantity": 1,
                "total": 38.0182984840272,
                "total_string": "38.02 ุฌ.ู…",
                "images": [
                    {
                        "id": "9fa5ece1-5c33-486f-97b1-bdd1f1b7770d",
                        "origin": "https://media.zid.store/thumbs/d297fb8b-c322-412e-a2f4-ffa96dc57022/9fa5ece1-5c33-486f-97b1-bdd1f1b7770d-thumbnail-500x500.png",
                        "thumbs": {
                            "fullSize": "https://media.zid.store/d297fb8b-c322-412e-a2f4-ffa96dc57022/9fa5ece1-5c33-486f-97b1-bdd1f1b7770d.png",
                            "thumbnail": "https://media.zid.store/thumbs/d297fb8b-c322-412e-a2f4-ffa96dc57022/9fa5ece1-5c33-486f-97b1-bdd1f1b7770d-thumbnail-370x370.png",
                            "small": "https://media.zid.store/thumbs/d297fb8b-c322-412e-a2f4-ffa96dc57022/9fa5ece1-5c33-486f-97b1-bdd1f1b7770d-thumbnail-500x500.png",
                            "medium": "https://media.zid.store/thumbs/d297fb8b-c322-412e-a2f4-ffa96dc57022/9fa5ece1-5c33-486f-97b1-bdd1f1b7770d-thumbnail-770x770.png",
                            "large": "https://media.zid.store/thumbs/d297fb8b-c322-412e-a2f4-ffa96dc57022/9fa5ece1-5c33-486f-97b1-bdd1f1b7770d-thumbnail-1000x1000.png"
                        }
                    }
                ]
            }
        ],
        "city": {
            "id": 5354,
            "national_id": null,
            "name": "Assuit",
            "priority": 0,
            "country_id": 63,
            "country_name": "Egypt",
            "country_code": "EG",
            "ar_name": "ุฃุณูŠูˆุท",
            "en_name": "Assuit"
        },
        "order_id": null,
        "history": [
            {
                "uuid": "23e4394c-2048-4a68-b95c-8310058c7d0f",
                "abandoned_cart_id": "b978fcc2-ccd0-45f6-81a7-7ab1f3b8f85d",
                "type": "Created Successfully",
                "created_at": "2025-12-27T14:53:32.000000Z",
                "updated_at": "2025-12-27T14:53:32.000000Z"
            },
            {
                "uuid": "6ffa538f-5be0-49f7-8e90-06c4b405b522",
                "abandoned_cart_id": "b978fcc2-ccd0-45f6-81a7-7ab1f3b8f85d",
                "type": "Reminder Sent",
                "created_at": "2025-12-28T14:53:39.000000Z",
                "updated_at": "2025-12-28T14:53:39.000000Z"
            },
            {
                "uuid": "ec62449e-fac5-4837-b640-32e94435f9d8",
                "abandoned_cart_id": "b978fcc2-ccd0-45f6-81a7-7ab1f3b8f85d",
                "type": "Reminder Sent",
                "created_at": "2025-12-27T15:53:27.000000Z",
                "updated_at": "2025-12-27T15:53:27.000000Z"
            }
        ],
        "phase": "payment_method",
        "customer_id": 15141670,
        "customer_name": "mahmoud aaaa",
        "customer_email": "a.alkallas@zid.sa",
        "customer_mobile": "966500000005",
        "reminders_count": 2,
        "cart_total": 509.8254,
        "cart_total_string": "509.83 ุฌ.ู…",
        "whatsapp_message": "Hello What'sapp",
        "created_at": "2025-12-27 14:45:44",
        "updated_at": "2025-12-28 14:53:39",
        "source": "catalog"
    },
    "message": {
        "type": "object",
        "code": null,
        "name": null,
        "description": null
    }
}
Modified atย 2026-02-01 14:39:33
Previous
List Carts
Next
Products
Built with