/orders
List sales orders
Returns a paginated list of sales orders for the authenticated tenant. Draft orders are excluded. The status filter is matched case-insensitively and an unknown value returns 400.
Show the full description
Sorted by order date descending. ?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.
Query parameters
| Field | Type | Description |
|---|---|---|
status
|
enum |
Filters on where the order stands in its fulfilment lifecycle.
Placed
Released
Closed
Cancelled
|
customerNumber
|
string | Returns only the orders placed by this customer number. |
orderDateFrom
|
string(date) | Returns only orders dated on or after this date (ISO 8601 date). |
orderDateTo
|
string(date) | Returns only orders dated on or before this date (ISO 8601 date). |
search
|
string | Matches order number and customer reference, case-insensitively and on partial words — ORD-2024 finds every order whose number or reference contains it. |
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_PublicOrderListItem
Paginated response: the fields below sit in items[], wrapped in totalCount, page, pageSize, totalPages, hasPreviousPage and hasNextPage. Paginated
| Field | Type | Description |
|---|---|---|
createdDate
|
string(date-time) | UTC timestamp when the order was created. |
currencyCode
|
string · nullable | ISO 4217 currency code for all monetary values on this order. |
customerName
|
string · nullable | Display name of the customer. Null if not set. |
customerNumber
|
string · nullable | Customer number of the buyer. Null if the order has no customer. |
customerReference
|
string · nullable | Customer's own reference / purchase order number. Null if not provided. |
deliveredPercentage
|
decimal | Share of the ordered quantity that has been delivered, 0-100. Serialised as a decimal string. |
deliveryStatus
|
enum |
How much of an order has actually been delivered. Derived from the ordered and
delivered quantities on the order lines, so it stays correct for partial deliveries —
the common case in B2B, where one line ships today and the rest next week.
NotDelivered
PartiallyDelivered
FullyDelivered
|
id
|
string(uuid) | Internal unique identifier (UUID v7). |
lineCount
|
integer | Number of order lines. |
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. |
orderDate
|
string(date) | Date the order was placed (ISO 8601 date). |
orderNumber
|
string · nullable | Unique order number, e.g. `ORD-2024-00042`. |
plannedDeliveryDate
|
string(date) · nullable | Planned delivery date set by fulfilment. Null if not yet planned. |
requestedDeliveryDate
|
string(date) · nullable | Requested delivery date from the customer. Null if not provided. |
status
|
enum |
Sales order status values exposed via the Public API.
Draft orders are never visible through the public API.
This describes where the order stands commercially, not what the warehouse is doing.
Warehouse progress belongs to shipments (see GET /preview/orders/{id}/shipments) —
an order can be split across several of them. How much has actually left the building
is reported separately as PublicApi.Preview.Orders.Queries.PublicDeliveryStatus.
Placed
Released
Closed
Cancelled
|
totalAmount
|
decimal | Total order amount excluding tax, in the order currency. Serialised as a decimal string. |
totalAmountIncludingTax
|
decimal | Total order amount including tax, in the order currency. Serialised as a decimal string. |
ProblemDetails
?status= got a value outside its list.
| Field | Type |
|---|---|
detail
|
string · nullable |
instance
|
string · nullable |
status
|
integer · nullable |
title
|
string · nullable |
type
|
string · nullable |
Standard errors:
401
403
Errors
Examples
curl "https://api.erp.fluit.cloud/preview/orders" \
-H "X-Api-Key: fluit_live_sk_..."{
"hasNextPage": true,
"hasPreviousPage": true,
"items": [
{
"createdDate": "2026-06-11T09:24:13.418",
"currencyCode": "SEK",
"customerName": "Acme AB",
"customerNumber": "CUST-001",
"customerReference": "PO-2026-042",
"deliveredPercentage": "12.50",
"deliveryStatus": "NotDelivered",
"id": "0f8b2c1e-4d3a-4b7e-9f10-2a6c5d8e1b44",
"lineCount": 42,
"links": {
"self": "string"
},
"modifiedDate": "2026-06-11T09:24:13.418",
"orderDate": "2026-06-11",
"orderNumber": "SO-2026-1041",
"plannedDeliveryDate": "2026-06-11",
"requestedDeliveryDate": "2026-06-11",
"status": "Placed",
"totalAmount": "299.00",
"totalAmountIncludingTax": "299.00"
}
],
"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.