/configurations
List saved configurations
Returns the configurations that have not yet become orders, oldest configuration number first.
Show the full description
A configuration disappears from this list once POST /preview/configurations/{configurationNumber}/order has turned it into a sales order — from that point it is an order and is read through GET /preview/orders instead. ?modifiedSince= (ISO 8601 UTC datetime) returns records created or changed at or after that instant, and is the intended way to run an incremental sync. A change anywhere inside the record counts: editing a line moves the parent's modifiedDate too, so no change can hide below the resource level. Deletions are not visible here: a deleted record is really gone, so it simply stops appearing, which is indistinguishable from "unchanged". Poll GET /preview/deletions?deletedSince= alongside this endpoint to learn what was removed. **One removal still has no tombstone: being ordered.** A configuration that has become a sales order is not deleted — it stops matching this list because it is now an order, so it appears in neither the delta nor GET /preview/deletions. Record the `orderNumber` from the response to the /order call, or reconcile against GET /preview/orders, to retire those local copies. The price fields (`unitPrice`, `totalPrice`, …) are **null** in this list — pricing a whole page would mean one price engine run per row. Read a single configuration, or use POST /preview/configurations/calculate, when you need prices. Paginated response: `{ items, totalCount, page, pageSize, totalPages, hasPreviousPage, hasNextPage }`. `?page=` defaults to 1, `?pageSize=` to 50 and is capped at 200.
Query parameters
| Field | Type | Description |
|---|---|---|
search
|
string | Matches configuration number, title and description, case-insensitively and on partial words. |
customerNumber
|
string | Returns only the configurations saved for this customer number. |
itemNumber
|
string | Returns only the configurations of this configurable item. |
modifiedSince
|
string(date-time) | Returns only records created or changed at or after this instant (ISO 8601 UTC datetime). A change anywhere inside the record counts, including on its lines. |
page
|
integer | Page to return, 1-based. Default 1. |
pageSize
|
integer | Number of records per page. Default 50, max 200. |
Responses
PagedResult_PublicConfigurationResponse
Paginated response: the fields below sit in items[], wrapped in totalCount, page, pageSize, totalPages, hasPreviousPage and hasNextPage. Paginated
| Field | Type | Description |
|---|---|---|
basePricePerUnit
|
decimal · nullable | The item's own price per unit from the price engine. Null on the list endpoint. |
configurationNumber
|
string · nullable | Unique configuration number — business key, e.g. `WO-1042`. Use it in every follow-up call. |
configurationPriceImpact
|
decimal | Total configuration surcharge for the whole quantity, in the tenant base currency, before the price engine runs. The priced fields below express the same thing in the customer's currency. |
configurationSurchargePerUnit
|
decimal · nullable | What the chosen options add per unit. Null on the list endpoint. |
createdDate
|
string(date-time) | UTC timestamp when the configuration was created. |
currencyCode
|
string · nullable | ISO 4217 code the priced fields below are expressed in. Null on the list endpoint — see the note on PublicApi.Preview.Configurations.Queries.PublicConfigurationResponse.UnitPrice. |
customerName
|
string · nullable | Customer name. Null when the configuration is anonymous. |
customerNumber
|
string · nullable | Customer number the configuration belongs to. Required before it can become an order. Null when the configuration is anonymous. |
description
|
string · nullable | Free-text description, e.g. which window the curtain is for. Null if not set. |
itemName
|
string · nullable | Display name of the configured product. |
itemNumber
|
string · nullable | Item number of the configured product. |
links
|
Links | Hypermedia links for a public API resource. Exposed as a computed `links` property on the public response DTOs so that create and read responses carry the same self-reference — the canonical URL is derived from the business key already present on the DTO and can never drift from the route it points at. |
modifiedDate
|
string(date-time) · nullable | UTC timestamp of the last modification. Null if never modified after creation. |
priceListName
|
string · nullable | Name of the price list that produced the base price. Null when no price list matched or on the list endpoint. |
priceSource
|
string · nullable | Where the base price came from in the price hierarchy, e.g. `CustomerPriceList`. Null on the list endpoint. |
quantity
|
decimal | How many units of the configured product. Expressed in the item's base unit. |
title
|
string · nullable | Free-text title. Defaults to the item name when not supplied. |
totalPrice
|
decimal · nullable | Unit price × quantity, excluding VAT, freight and order-level discounts. Null on the list endpoint. |
unitPrice
|
decimal · nullable | Base price plus surcharge — the unit price the order line will get, priced as of now. Only populated when a single configuration is returned (create, get by number, reconfigure). On GET /preview/configurations it is `null`: pricing a whole page would mean one price engine run per row. Read one configuration, or use POST /preview/configurations/calculate, when you need the price for a list. |
values
|
ConfigurationValue[] · nullable | The chosen values, one per feature that has a value. |
warehouseCode
|
string · nullable | Warehouse code the configuration is planned against. Null when not set. |
Standard errors:
401
403
Errors
Examples
curl "https://api.erp.fluit.cloud/preview/configurations" \
-H "X-Api-Key: fluit_live_sk_..."{
"hasNextPage": true,
"hasPreviousPage": true,
"items": [
{
"basePricePerUnit": "299.00",
"configurationNumber": "CFG-2026-0058",
"configurationPriceImpact": "299.00",
"configurationSurchargePerUnit": "299.00",
"createdDate": "2026-06-11T09:24:13.418",
"currencyCode": "SEK",
"customerName": "Acme AB",
"customerNumber": "CUST-001",
"description": "string",
"itemName": "Widget A",
"itemNumber": "WIDGET-A",
"links": {
"self": "string"
},
"modifiedDate": "2026-06-11T09:24:13.418",
"priceListName": "Retail 2026",
"priceSource": "string",
"quantity": "10",
"title": "string",
"totalPrice": "299.00",
"unitPrice": "299.00",
"values": [
{
"boolean": true,
"featureCode": "STD",
"featureName": "Width",
"featureType": "Text",
"isMeasured": true,
"itemNumber": "WIDGET-A",
"number": "299.00",
"optionCode": "STD",
"optionName": "White",
"text": "string"
}
],
"warehouseCode": "MAIN"
}
],
"page": 1,
"pageSize": 50,
"totalCount": 137,
"totalPages": 3
}Base URL https://api.erp.fluit.cloud/preview. The response example is generated from the schema: the shape is right, the values are made up.