---
url: https://docs.youcan.shop/store-front/customers/orders/listing.md
---
# List customer orders

Endpoint: `https://my-store.youcan.shop/api/customers/orders`

Method: `GET`

Lists the orders of the logged in customer, newest first.

## Parameters

| Param Name | Param Type | Description | Required |
| --- | --- | --- | --- |
| `page` | integer | The page, from 1 | optional |
| `limit` | integer | Orders per page, from 1 to 50. The default is 10 | optional |

## Response

Send the customer token from the [Login endpoint](/store-front/customers/login) in the `Authorization` header.

\[401] Unauthorized

```json
{
    "status": 401,
    "detail": "Unauthenticated.",
    "meta": []
}
```

\[200] OK

```json
{
    "data": [
        {
            "id": "12d23b0b-2efd-44c5-af88-360e144147bb",
            "ref": "1042",
            "status": "open",
            "payment_status": "paid",
            "shipping_status": "unfulfilled",
            "total": 250,
            "currency": "MAD",
            "items": [
                {
                    "name": "Linen shirt",
                    "variations": {
                        "size": "M"
                    },
                    "quantity": 1,
                    "price": 250
                }
            ],
            "created_at": "2026-10-05T14:19:05+00:00"
        }
    ],
    "meta": {
        "pagination": {
            "total": 1,
            "count": 1,
            "per_page": 10,
            "current_page": 1,
            "total_pages": 1,
            "links": {}
        }
    }
}
```