List quotes

Returns the quotes as a flat array, newest-first, optionally narrowed by customer, store and/or status (draft | sent | accepted | expired | cancelled). This is the clienteling devis list — for a single estimate use the get operation.

GET /v1/quotes

Error

A valid request URL is required to generate request examples

200

[
  {
    "id": "quote-ok",
    "customerId": "cust-1",
    "storeId": "shop-1",
    "currency": "EUR",
    "lines": [
      {
        "description": "Custom sofa",
        "skuId": null,
        "quantity": 1,
        "unitPriceCents": 120000,
        "vatRate": 20
      }
    ],
    "validUntil": "2030-01-01T00:00:00.000Z",
    "status": "draft",
    "actorId": "user-associate-1",
    "createdAt": "2026-07-28T09: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

customer · string

Narrow to one customer's quotes (devis) by id.

store · string

Narrow to one store's quotes by store id.

status · enum<string>

Filter by status: draft | sent | accepted | expired | cancelled.

Available options: draft, sent, accepted, expired, cancelled

Response

200

application/json

The matching quotes (empty array when none match).

id · string · required

customerId · string · required

storeId · string · required

currency · string · required

lines · object[] · required

Show child attributes

validUntil · string · required

status · enum<string> · required

Available options: draft, sent, accepted, expired, cancelled

actorId · string · required

createdAt · string · required

Example:

[
  {
    "id": "quote-ok",
    "customerId": "cust-1",
    "storeId": "shop-1",
    "currency": "EUR",
    "lines": [
      {
        "description": "Custom sofa",
        "skuId": null,
        "quantity": 1,
        "unitPriceCents": 120000,
        "vatRate": 20
      }
    ],
    "validUntil": "2030-01-01T00:00:00.000Z",
    "status": "draft",
    "actorId": "user-associate-1",
    "createdAt": "2026-07-28T09:00:00.000Z"
  }
]