u

docs/api/routes/quote/list.md

@@ -8,6 +8,15 @@ Lists quotes (`manifest` rows with `type = 'quote'`)
 for the authenticated user's selected company.
 
 
+## Query parameters
+
+| Param | Required | Type | Description |
+|-------|----------|------|-------------|
+| `offset` | no | integer | Number of quotes to skip |
+| `limit` | no | integer | Number of quotes to return |
+| `search` | no | string | Free-text search matching quote number, external number, or customer name |
+| `seekMonths` | no | integer | Negative integer for cutoff months ago (e.g. -1 for quotes older than 1 month) |
+
 ## Response `200`
 
 Quote list
@@ -21,9 +30,30 @@ Quote list
       "type": "quote",
       "entityId": 1,
       "date": "2026-08-10T00:00:00.000Z",
-      "createdAt": "2026-08-10T00:00:00.000Z"
+      "createdAt": "2026-08-10T00:00:00.000Z",
+      "positions": 1,
+      "grossTotal": 1,
+      "totalQuantity": 1,
+      "customerName": "…",
+      "lines": [
+        {
+          "id": 1,
+          "sku": "…",
+          "name": "…",
+          "pu": 1,
+          "amount": 1,
+          "net": 1,
+          "rebate": 1,
+          "taxrate": 1,
+          "comment": "…"
+        }
+      ]
     }
-  ]
+  ],
+  "total": 1,
+  "unfilteredTotal": 1,
+  "offset": 1,
+  "limit": 1
 }
 ```
 
@@ -31,7 +61,7 @@ Quote list
 
 | Status | Description |
 |--------|-------------|
-| 400 | No company selected — `{"error":"…"}` |
+| 400 | Invalid query parameters, invalid offset, invalid limit, or no company selected — `{"error":"…"}` |
 | 401 | Unauthorized — `{"error":"…"}` |
 | 403 | Not authorized — `{"error":"…"}` |
 | 404 | Company not found — `{"error":"…"}` |