Error
A valid request URL is required to generate request examples{
"id": "WEB-24810",
"channel": "web",
"deliveryMode": "click-and-collect",
"customer": {
"customerId": "cust-24810",
"displayName": "Camille Laurent"
},
"lines": [
{
"skuId": "f139995b359e2702f33b391acb3d42a419197a7b2c09d04c1fe6d97ecefe4feb",
"quantity": 1,
"unitPriceCents": 11900
}
],
"status": "accepted",
"fulfillingStoreId": "store-lyon",
"routingExplanation": {
"basis": "criterion",
"criterionIndex": 0,
"criterionKind": "stock-depth",
"runnerUpStoreId": "store-rivoli"
},
"actorId": "user-camille",
"capturedAt": "2026-07-28T10:00:00.000Z"
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123,
"fieldErrors": [
{
"field": "<string>",
"message": "<string>"
}
]
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}Orders
Get an order by id
Returns the full order read model for one order — its lifecycle status, the fulfillingStoreId (null until routed), the customer and the ordered lines. 404s when no order carries the given id.
GET
/
v1
/
orders
/
{id}
Error
A valid request URL is required to generate request examples{
"id": "WEB-24810",
"channel": "web",
"deliveryMode": "click-and-collect",
"customer": {
"customerId": "cust-24810",
"displayName": "Camille Laurent"
},
"lines": [
{
"skuId": "f139995b359e2702f33b391acb3d42a419197a7b2c09d04c1fe6d97ecefe4feb",
"quantity": 1,
"unitPriceCents": 11900
}
],
"status": "accepted",
"fulfillingStoreId": "store-lyon",
"routingExplanation": {
"basis": "criterion",
"criterionIndex": 0,
"criterionKind": "stock-depth",
"runnerUpStoreId": "store-rivoli"
},
"actorId": "user-camille",
"capturedAt": "2026-07-28T10:00:00.000Z"
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123,
"fieldErrors": [
{
"field": "<string>",
"message": "<string>"
}
]
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}Authorizations
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.
Path Parameters
Id of the order (commande) to read or transition.
Minimum string length:
1Response
The order read model.
The order read model.
Available options:
web, marketplace, mobile-app, in-store Available options:
click-and-collect, ship-from-store, endless-aisle Show child attributes
Show child attributes
Show child attributes
Show child attributes
Available options:
captured, accepted, fulfilled, cancelled, rejected Show child attributes
Show child attributes

