API documentation

Everything you need to integrate with the Gini v2 Third-Party API.

Getting started API reference Store API Finance API Settings API Insights API Wholesale API Resources

Profile Categories Products Attributes Product Variants Product Add-ons Discounts Orders Abandoned carts Reviews Notifications Collections Reels Influencers Exports Webhooks

API reference

Abandoned carts

List customers who left products in their cart without ordering, and read any one customer's cart in full — the same data as the dashboard's Abandoned carts screen. Read-only.

List abandoned carts

One row per customer, with the number of lines, units, the cart's value, and when it was last touched. Paginated.

GET /api/v2.0/third-party/abandoned-carts

Signed

Query parameters

Field	Type	Required	Description
`search`	string	Optional	Match a customer by name or phone.
`hours`	integer	Optional	Only carts older than this many hours.
`product_id`	integer	Optional	Only carts containing this product (must be yours).
`sort`	string	Optional	recent (default), stale, or value.
`per_page`	integer	Optional	1–100, default 15.

Response

{
    "data": [
        {
            "customer": {
                "id": 501,
                "name": "Ahmed",
                "contact_phone": "07701234567"
            },
            "items_count": 3,
            "units_count": 5,
            "cart_value": 45000,
            "latest_cart": "2026-09-08T20:14:00.000000Z"
        }
    ],
    "meta": {
        "current_page": 1,
        "last_page": 4,
        "per_page": 15,
        "total": 52
    }
}

Notes

contact_phone is the customer's reachable number (their saved contact number, or a number from a saved address), normalised to the local 07… form; null when none is on file.
This is the customer's contact number, not an order delivery number — abandoned carts are not orders, so there is no delivery-address snapshot.
product_id that is not yours is rejected with HTTP 422.

Get one customer's cart

Every line in a single customer's abandoned cart, scoped to your products.

GET /api/v2.0/third-party/abandoned-carts/{customer}

Signed

Response

{
    "data": {
        "customer": {
            "id": 501,
            "name": "Ahmed",
            "contact_phone": "07701234567"
        },
        "items": [
            {
                "id": 90,
                "quantity": 2,
                "effective_price": 15000,
                "total_price": 30000,
                "added_at": "2026-09-08T20:14:00.000000Z",
                "product": {
                    "id": 101,
                    "name": "Headphones",
                    "slug": "headphones",
                    "price": 15000
                },
                "variant": {
                    "id": 12,
                    "price": 15000,
                    "attributes": [
                        {
                            "name": "Color",
                            "value": "Black"
                        }
                    ]
                },
                "addons": []
            }
        ]
    }
}

Notes

The {customer} path parameter is the numeric customer id (from the list response).
A customer with no cart in your products returns HTTP 404.

Previous Orders Next Reviews