---
url: https://docs.youcan.shop/store-admin/abandoned-carts/listing.md
---
# Get Abandoned Carts List

Endpoint: `https://api.youcan.shop/abandoned-carts`

Method: `GET`

## Required Scopes

* `read-abandoned-carts`

## Query Parameters

* `page`: The page number for pagination.
* `limit`: The number of carts to return per page.

Carts are sorted by creation date, newest first. See [Abandoned Cart](/store-admin/entities/abandoned-cart) for the fields.

## Response

\[200]

```json
{
    "data": [
        {
            "id": "e4c8b680-a491-459a-896d-4beb84528d5a",
            "reminders_count": 1,
            "is_recovered": false,
            "recovered_order_id": null,
            "recovered_at": null,
            "extra_fields": null,
            "created_at": 1790679530,
            "updated_at": 1790680130,
            "items": [
                {
                    "id": "27aeed80-61cd-42ad-bc03-5d76a96910f1",
                    "product_variant_id": "a3a196c2-69a4-4405-9a71-c3400dc44f96",
                    "price": 200,
                    "quantity": 1,
                    "extra_fields": null,
                    "created_at": 1790679530,
                    "updated_at": 1790679530,
                    "variant": {
                        "id": "a3a196c2-69a4-4405-9a71-c3400dc44f96",
                        "product_id": "b8e32450-9e8a-4f11-9b98-2e599e4958dd",
                        "variations": { "default": "default" },
                        "options": ["default"],
                        "values": ["default"],
                        "price": 200,
                        "compare_at_price": 250,
                        "weight": 0,
                        "sku": "",
                        "barcode": "",
                        "inventory": 5,
                        "is_selected": false,
                        "is_default": false,
                        "image": { "name": null, "url": null },
                        "created_at": "2026-08-10T00:41:07+00:00",
                        "updated_at": "2026-08-10T00:41:07+00:00"
                    }
                }
            ],
            "customer": {
                "id": "5b1f3c1e-8c7a-4d0e-9d5f-2a6b7c8d9e0f",
                "first_name": "Ada",
                "last_name": "Lovelace",
                "full_name": "Ada Lovelace",
                "email": "ada@example.com",
                "phone": "+212600000000",
                "country": "Morocco",
                "city": "Casablanca",
                "...": "..."
            },
            "shipping_address": [],
            "billing_address": []
        }
    ],
    "meta": {
        "pagination": {
            "total": 42,
            "count": 1,
            "per_page": 1,
            "current_page": 1,
            "total_pages": 42,
            "links": {
                "next": "https://api.youcan.shop/abandoned-carts?limit=1&page=2"
            }
        }
    }
}
```