List open parked sales

Returns the open held carts (the ‘Ventes en attente’ list) — the only listable state; resumed and dropped sales are excluded. Pass ?store=<id> to narrow to one store so a sale parked there can be resumed from another till. Returns an array (empty when none).

GET /v1/parked

Error

A valid request URL is required to generate request examples

200

[
  {
    "id": "p-ok",
    "storeId": "shop-1",
    "customerName": "Alice",
    "cart": {
      "lines": [
        {
          "id": "sku-1",
          "skuId": "sku-1",
          "quantity": 2,
          "unitPrice": 4990,
          "vatRate": 20,
          "free": false
        }
      ],
      "freeLineSequence": 1
    },
    "status": "open",
    "actorId": "cashier-1",
    "parkedAt": "2026-01-02T10:00:00.000Z"
  }
]

Authorizations

Authorization · string · header · required

Authorization: Bearer <token>. Accepts EITHER a Keycloak access token (scopes-in-token) OR an opaque POS session token; both resolve to the same pos.* scope vocabulary the route guards enforce.

Query Parameters

store · string

Narrow to one store's open parked sales (ventes en attente) by store id.

Response

200

application/json

The open held carts (one row per parked sale).

id · string · required

storeId · string · required

customerName · string | null · required

cart · object · required

Show child attributes

status · enum<string> · required

Available options: open, resumed, dropped

actorId · string · required

parkedAt · string<date-time> · required

Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$

Example:

[
  {
    "id": "p-ok",
    "storeId": "shop-1",
    "customerName": "Alice",
    "cart": {
      "lines": [
        {
          "id": "sku-1",
          "skuId": "sku-1",
          "quantity": 2,
          "unitPrice": 4990,
          "vatRate": 20,
          "free": false
        }
      ],
      "freeLineSequence": 1
    },
    "status": "open",
    "actorId": "cashier-1",
    "parkedAt": "2026-01-02T10:00:00.000Z"
  }
]