Orders Get by Id

Order Detail — `GET /orders/v1/{orderId}`

Order State

There is no explicit status field on the detail response. State is derived from events and quantities:

Derived State	Condition
Open	`events` contains only `Placed` — no delivery created yet
In Progress	A delivery exists but not all lines are fulfilled (`fulfilled < total`)
Completed	`events` contains `Completed`
Cancelled	`events` contains `Cancelled`

The explicit status string ("Open", "InProgress", "Completed", "Cancelled") is available on the list endpoint only.

Order Lifecycle Examples

Open Order

Order placed. No processing started yet. All quantity in expectedDeliveries.

Response — Open order (2000100001)

{
  "order": {
    "orderId": "2000100001",
    "checkoutId": "0000000000000000000000000000000000000000000000000000000000000001",
    "currency": "NOK",
    "events": {
      "Placed": "2026-06-18T09:38:03.0729832+02:00"
    },
    "parties": {
      "soldTo": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "shipTo": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "billTo": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "contactTo": "c3d4e5f6-a7b8-9012-cdef-123456789012",
      "placedBy": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
    },
    "references": null,
    "orderLines": [
      {
        "lineNumber": "100",
        "name": "Logitech MX Keys S Trådløst Tastatur",
        "description": "Trådløst tastatur med bakgrunnsbelyste taster og USB-C-lading",
        "materialNumber": "1000001",
        "quantity": { "total": 1, "fulfilled": 0, "cancelled": 0 },
        "unitPrice": { "gross": 850.0, "net": 680.0, "vat": 170.0 },
        "references": null,
        "categories": ["PHYSICAL_ITEM"],
        "orderLines": []
      },
      {
        "lineNumber": "200",
        "name": "Logitech G700s Trådløs Gaming Mus",
        "description": "trådløs, 13 programmebare knapper, 8200 dpi",
        "materialNumber": "1000002",
        "quantity": { "total": 1, "fulfilled": 0, "cancelled": 0 },
        "unitPrice": { "gross": 500.0, "net": 500.0, "vat": 0.0 },
        "references": null,
        "categories": ["PHYSICAL_ITEM"],
        "orderLines": []
      },
      {
        "lineNumber": "300",
        "name": "Hjemlevering",
        "description": "",
        "materialNumber": "2000001",
        "quantity": { "total": 1, "fulfilled": 0, "cancelled": 0 },
        "unitPrice": { "gross": 156.25, "net": 125.0, "vat": 31.25 },
        "references": null,
        "categories": ["DELIVERY"],
        "orderLines": []
      }
    ],
    "expectedDeliveries": [
      {
        "estimatedDeliveryDate": "2026-06-19T00:00:00+02:00",
        "expectedLines": [
          { "orderLineNumber": "100", "quantity": 1, "references": null, "status": "ConfirmedRestock", "availableAt": "2026-06-19T00:00:00+02:00" },
          { "orderLineNumber": "200", "quantity": 1, "references": null, "status": "Available", "availableAt": "2026-06-18T00:00:00+02:00" },
          { "orderLineNumber": "300", "quantity": 1, "references": null, "status": "Available", "availableAt": "2026-06-18T00:00:00+02:00" }
        ],
        "collectionPoint": null,
        "deliveryAddress": {
          "name": "Example Company AS",
          "addressLine1": "1 Example Street",
          "addressLine2": "",
          "postCode": "0000",
          "city": "EXAMPLETOWN",
          "country": "NO",
          "contactPersonName": "Jane Doe",
          "phone": "55555555",
          "mobilePhone": "55555555",
          "email": "jane.doe@example.com",
          "globalLocationNumber": null
        }
      }
    ],
    "deliveries": [],
    "billings": []
  }
}

Initial state:

expectedDeliveries lists all lines pending shipment with an estimated date
deliveries and billings are empty arrays

In Progress — Partial Fulfillment

Delivery created for some lines. Remaining lines still in expectedDeliveries. fulfilled < total on partially shipped lines.

Response — Partially fulfilled (2000100001, after partial shipment)

{
  "order": {
    "orderId": "2000100001",
    "events": {
      "Placed": "2026-06-18T09:38:03.0729832+02:00"
    },
    "orderLines": [
      {
        "lineNumber": "100",
        "name": "Logitech MX Keys S Trådløst Tastatur",
        "quantity": { "total": 1, "fulfilled": 1, "cancelled": 0 },
        "categories": ["PHYSICAL_ITEM"],
        "orderLines": []
      },
      {
        "lineNumber": "200",
        "name": "Logitech G700s Trådløs Gaming Mus",
        "quantity": { "total": 1, "fulfilled": 0, "cancelled": 0 },
        "categories": ["PHYSICAL_ITEM"],
        "orderLines": []
      },
      {
        "lineNumber": "300",
        "name": "Hjemlevering",
        "quantity": { "total": 1, "fulfilled": 1, "cancelled": 0 },
        "categories": ["DELIVERY"],
        "orderLines": []
      }
    ],
    "expectedDeliveries": [
      {
        "estimatedDeliveryDate": "2026-06-20T00:00:00+02:00",
        "expectedLines": [
          { "orderLineNumber": "200", "quantity": 1, "references": null, "status": "UnconfirmedRestock", "availableAt": "2026-06-20T00:00:00+02:00" }
        ],
        "collectionPoint": null,
        "deliveryAddress": {
          "name": "Example Company AS",
          "addressLine1": "1 Example Street",
          "postCode": "0000",
          "city": "EXAMPLETOWN",
          "country": "NO"
        }
      }
    ],
    "deliveries": [
      {
        "deliveryId": "8100000001",
        "trackingNumber": "00000000000000000001",
        "events": {
          "Created": "2026-06-18T10:13:04+00:00",
          "Picked": "2026-06-18T10:14:24+00:00",
          "Sent": "2026-06-18T10:15:38+00:00"
        },
        "deliveryLines": [
          {
            "lineNumber": "100",
            "quantity": 1,
            "orderLineNumber": "100",
            "serialNumbers": []
          },
          {
            "lineNumber": "200",
            "quantity": 1,
            "orderLineNumber": "300",
            "serialNumbers": []
          }
        ],
        "collectionPoint": null,
        "deliveryAddress": {
          "name": "Example Company AS",
          "addressLine1": "1 Example Street",
          "postCode": "0000",
          "city": "EXAMPLETOWN",
          "country": "NO"
        }
      }
    ],
    "billings": []
  }
}

Changes from Open:

Line 100 and 300: fulfilled incremented to 1; line 200 remains 0
expectedDeliveries: now only contains remaining line 200
deliveries: delivery 8100000001 added with Created → Picked → Sent events
No Completed event yet — order is In Progress

Completed — All Lines Fulfilled

All lines shipped or cancelled. events.Completed present.

Response — Fully fulfilled and completed (2000100002)

{
  "order": {
    "orderId": "2000100002",
    "events": {
      "Placed": "2026-06-18T11:18:56.4459064+02:00",
      "Completed": "2026-06-18T11:38:05.023+02:00"
    },
    "orderLines": [
      {
        "lineNumber": "100",
        "name": "Logitech MX Keys S Trådløst Tastatur",
        "quantity": { "total": 1, "fulfilled": 1, "cancelled": 0 },
        "categories": ["PHYSICAL_ITEM"],
        "orderLines": []
      },
      {
        "lineNumber": "200",
        "name": "Hjemlevering",
        "quantity": { "total": 1, "fulfilled": 1, "cancelled": 0 },
        "categories": ["DELIVERY"],
        "orderLines": []
      }
    ],
    "expectedDeliveries": [],
    "deliveries": [
      {
        "deliveryId": "8100000002",
        "trackingNumber": "00000000000000000002",
        "events": {
          "Created": "2026-06-18T09:20:12+00:00",
          "Picked": "2026-06-18T09:21:03+00:00",
          "Sent": "2026-06-18T09:36:57+00:00"
        },
        "deliveryLines": [
          {
            "lineNumber": "100",
            "quantity": 1,
            "orderLineNumber": "100",
            "serialNumbers": []
          },
          {
            "lineNumber": "200",
            "quantity": 1,
            "orderLineNumber": "200",
            "serialNumbers": []
          }
        ],
        "collectionPoint": null,
        "deliveryAddress": {
          "name": "Example Company AS",
          "addressLine1": "1 Example Street",
          "postCode": "0000",
          "city": "EXAMPLETOWN",
          "country": "NO"
        }
      }
    ],
    "billings": [
      {
        "billingId": "9100000001",
        "events": { "Billed": "2026-06-18T11:38:05.023+02:00" },
        "type": "Invoice",
        "billingLine": [
          {
            "lineNumber": "100",
            "quantity": 1,
            "orderLineNumber": "100",
            "serialNumbers": []
          },
          {
            "lineNumber": "200",
            "quantity": 1,
            "orderLineNumber": "200",
            "serialNumbers": []
          }
        ]
      }
    ]
  }
}

Changes from In Progress:

events.Completed added
expectedDeliveries is now []
billings contains an Invoice entry

Cancelled — Fully Cancelled

Order cancelled before any fulfillment.

Response — Fully cancelled (2000100003)

{
  "order": {
    "orderId": "2000100003",
    "events": {
      "Placed": "2026-06-18T11:56:56.7668337+02:00",
      "Cancelled": "2026-06-18T12:01:58.565+02:00"
    },
    "orderLines": [
      {
        "lineNumber": "100",
        "name": "Logitech MX Keys S Trådløst Tastatur",
        "quantity": { "total": 1, "fulfilled": 0, "cancelled": 1 },
        "categories": ["PHYSICAL_ITEM"],
        "orderLines": []
      },
      {
        "lineNumber": "200",
        "name": "Hjemlevering",
        "quantity": { "total": 1, "fulfilled": 0, "cancelled": 1 },
        "categories": ["DELIVERY"],
        "orderLines": []
      }
    ],
    "expectedDeliveries": [],
    "deliveries": [],
    "billings": []
  }
}

Changes from Open:

events.Cancelled added
All quantities: cancelled incremented to match total; fulfilled stays 0
expectedDeliveries cleared to []

Partially Cancelled After Partial Fulfillment

One item shipped, another cancelled. Order completes when no remaining open quantity.

Response — One shipped, one cancelled (2000100001, final state)

{
  "order": {
    "orderId": "2000100001",
    "events": {
      "Placed": "2026-06-18T09:38:03.0729832+02:00",
      "Completed": "2026-06-18T11:17:02.697+02:00"
    },
    "orderLines": [
      {
        "lineNumber": "100",
        "name": "Logitech MX Keys S Trådløst Tastatur",
        "quantity": { "total": 1, "fulfilled": 1, "cancelled": 0 }
      },
      {
        "lineNumber": "200",
        "name": "Logitech G700s Trådløs Gaming Mus",
        "quantity": { "total": 1, "fulfilled": 0, "cancelled": 1 }
      },
      {
        "lineNumber": "300",
        "name": "Hjemlevering",
        "quantity": { "total": 1, "fulfilled": 1, "cancelled": 0 }
      }
    ],
    "expectedDeliveries": [],
    "deliveries": [
      {
        "deliveryId": "8100000001",
        "events": {
          "Created": "...",
          "Picked": "...",
          "Sent": "2026-06-18T10:15:38+00:00"
        },
        "deliveryLines": [
          {
            "lineNumber": "100",
            "quantity": 1,
            "orderLineNumber": "100",
            "serialNumbers": []
          },
          {
            "lineNumber": "200",
            "quantity": 1,
            "orderLineNumber": "300",
            "serialNumbers": []
          }
        ]
      }
    ],
    "billings": [
      {
        "billingId": "9100000002",
        "events": { "Billed": "2026-06-18T11:17:02.697+02:00" },
        "type": "Invoice",
        "billingLine": [
          {
            "lineNumber": "100",
            "quantity": 1,
            "orderLineNumber": "100",
            "serialNumbers": []
          },
          {
            "lineNumber": "200",
            "quantity": 1,
            "orderLineNumber": "300",
            "serialNumbers": []
          }
        ]
      }
    ]
  }
}

Key points:

Completed fires when all lines are either fulfilled or cancelled after some were fulfilled — no remaining open quantity
The invoice only covers the lines that were actually shipped (lines 100 and 300); cancelled line 200 is absent from billing
expectedDeliveries is [] — both the shipped entry and the cancelled entry are resolved

Delivery Scenarios

Split Delivery

When a warehouse cannot ship all items together, multiple deliveries are created for a single order.

Response — Two deliveries (2000100004)

{
  "order": {
    "orderId": "2000100004",
    "events": {
      "Placed": "2026-06-18T15:35:54.1397713+02:00",
      "Completed": "2026-06-18T15:55:48.851+02:00"
    },
    "orderLines": [
      {
        "lineNumber": "100",
        "name": "Logitech MX Keys S Trådløst Tastatur",
        "quantity": { "total": 2, "fulfilled": 2, "cancelled": 0 },
        "categories": ["PHYSICAL_ITEM"],
        "orderLines": []
      },
      {
        "lineNumber": "200",
        "name": "Hjemlevering",
        "quantity": { "total": 1, "fulfilled": 1, "cancelled": 0 },
        "categories": ["DELIVERY"],
        "orderLines": []
      }
    ],
    "expectedDeliveries": [],
    "deliveries": [
      {
        "deliveryId": "8100000003",
        "trackingNumber": "00000000000000000003",
        "events": {
          "Created": "2026-06-18T13:37:11+00:00",
          "Picked": "2026-06-18T13:38:03+00:00",
          "Sent": "2026-06-18T13:41:10+00:00"
        },
        "deliveryLines": [
          {
            "lineNumber": "100",
            "quantity": 1,
            "orderLineNumber": "100",
            "serialNumbers": []
          }
        ]
      },
      {
        "deliveryId": "8100000004",
        "trackingNumber": "00000000000000000004",
        "events": {
          "Created": "2026-06-18T13:42:17+00:00",
          "Picked": "2026-06-18T13:43:02+00:00",
          "Sent": "2026-06-18T13:53:37+00:00"
        },
        "deliveryLines": [
          {
            "lineNumber": "100",
            "quantity": 1,
            "orderLineNumber": "100",
            "serialNumbers": []
          },
          {
            "lineNumber": "200",
            "quantity": 1,
            "orderLineNumber": "200",
            "serialNumbers": []
          }
        ]
      }
    ],
    "billings": [
      {
        "billingId": "9100000003",
        "events": { "Billed": "2026-06-18T15:41:30.000+02:00" },
        "type": "Invoice",
        "billingLine": [
          {
            "lineNumber": "100",
            "quantity": 1,
            "orderLineNumber": "100",
            "serialNumbers": []
          }
        ]
      },
      {
        "billingId": "9100000004",
        "events": { "Billed": "2026-06-18T15:55:48.851+02:00" },
        "type": "Invoice",
        "billingLine": [
          {
            "lineNumber": "100",
            "quantity": 1,
            "orderLineNumber": "100",
            "serialNumbers": []
          },
          {
            "lineNumber": "200",
            "quantity": 1,
            "orderLineNumber": "200",
            "serialNumbers": []
          }
        ]
      }
    ]
  }
}

Key points:

deliveries can have multiple entries — one per shipment
Line 100 (quantity.total = 2) is split: 1 unit in each delivery
Billing is usually generated per delivery — here each of the two deliveries produces its own invoice. Exceptionally, a single billing can cover multiple deliveries

Collection Point

Order shipped to a parcel locker or pickup point. The collection point address is included on both the expectedDeliveries entry and the deliveries entry.

Response — Collection point, in progress (2000100005)

{
  "order": {
    "orderId": "2000100005",
    "events": { "Placed": "2026-06-18T16:07:41.8716412+02:00" },
    "orderLines": [
      {
        "lineNumber": "100",
        "name": "Logitech MX Keys S Trådløst Tastatur",
        "quantity": { "total": 1, "fulfilled": 0, "cancelled": 0 },
        "categories": ["PHYSICAL_ITEM"],
        "orderLines": []
      },
      {
        "lineNumber": "200",
        "name": "Til Pakkeboks",
        "quantity": { "total": 1, "fulfilled": 0, "cancelled": 0 },
        "categories": ["DELIVERY"],
        "orderLines": []
      }
    ],
    "expectedDeliveries": [
      {
        "estimatedDeliveryDate": null,
        "expectedLines": [
          { "orderLineNumber": "100", "quantity": 1, "references": null, "status": "Unknown", "availableAt": null },
          { "orderLineNumber": "200", "quantity": 1, "references": null, "status": "Unknown", "availableAt": null }
        ],
        "collectionPoint": {
          "id": "6453369",
          "name": "Pakkeautomat Kiwi Laskentunet",
          "addressLine": "Øvre Laskenvei 28",
          "postCode": "0000",
          "city": "EXAMPLETOWN",
          "country": "NO"
        },
        "deliveryAddress": {
          "name": "Example Company AS",
          "addressLine1": "1 Example Street",
          "postCode": "0000",
          "city": "EXAMPLETOWN",
          "country": "NO"
        }
      }
    ],
    "deliveries": [],
    "billings": []
  }
}

Changes after shipment:

Response — Collection point, completed (2000100005)

{
  "order": {
    "orderId": "2000100005",
    "events": {
      "Placed": "2026-06-18T16:07:41.8716412+02:00",
      "Completed": "2026-06-18T16:12:32.031+02:00"
    },
    "orderLines": [
      {
        "lineNumber": "100",
        "name": "Logitech MX Keys S Trådløst Tastatur",
        "quantity": { "total": 1, "fulfilled": 1, "cancelled": 0 },
        "categories": ["PHYSICAL_ITEM"],
        "orderLines": []
      },
      {
        "lineNumber": "200",
        "name": "Til Pakkeboks",
        "quantity": { "total": 1, "fulfilled": 1, "cancelled": 0 },
        "categories": ["DELIVERY"],
        "orderLines": []
      }
    ],
    "expectedDeliveries": [],
    "deliveries": [
      {
        "deliveryId": "8100000005",
        "trackingNumber": "70000000000000001",
        "events": {
          "Created": "2026-06-18T14:08:38+00:00",
          "Picked": "2026-06-18T14:09:45+00:00",
          "Sent": "2026-06-18T14:11:18+00:00"
        },
        "deliveryLines": [
          {
            "lineNumber": "100",
            "quantity": 1,
            "orderLineNumber": "100",
            "serialNumbers": ["SN000000000001"]
          },
          {
            "lineNumber": "200",
            "quantity": 1,
            "orderLineNumber": "200",
            "serialNumbers": []
          }
        ],
        "collectionPoint": {
          "id": "6453369",
          "name": "Pakkeautomat Kiwi Laskentunet",
          "addressLine": "Øvre Laskenvei 28",
          "postCode": "0000",
          "city": "EXAMPLETOWN",
          "country": "NO"
        },
        "deliveryAddress": {
          "name": "Example Company AS",
          "addressLine1": "1 Example Street",
          "postCode": "0000",
          "city": "EXAMPLETOWN",
          "country": "NO"
        }
      }
    ],
    "billings": [
      {
        "billingId": "9100000004",
        "events": { "Billed": "2026-06-18T16:12:32.031+02:00" },
        "type": "Invoice",
        "billingLine": [
          {
            "lineNumber": "100",
            "quantity": 1,
            "orderLineNumber": "100",
            "serialNumbers": ["SN000000000001"]
          },
          {
            "lineNumber": "200",
            "quantity": 1,
            "orderLineNumber": "200",
            "serialNumbers": []
          }
        ]
      }
    ]
  }
}

Key points:

collectionPoint is present on both the expectedDeliveries entry and the deliveries entry
Serial numbers (serialNumbers[]) appear on delivery lines and billing lines after the Sent event fires

Billing

Invoice

Standard billing document. Created when lines are shipped.

See the Completed and Collection Point examples above.

Credit Note

Created after a return. References the same order lines as the original invoice.

Response — Invoice + Credit Note (2000100005, after return of line 100)

{
  "order": {
    "orderId": "2000100005",
    "events": {
      "Placed": "2026-06-18T16:07:41.8716412+02:00",
      "Completed": "2026-06-18T16:12:32.031+02:00"
    },
    "billings": [
      {
        "billingId": "9100000004",
        "events": { "Billed": "2026-06-18T16:12:32.031+02:00" },
        "type": "Invoice",
        "billingLine": [
          {
            "lineNumber": "100",
            "quantity": 1,
            "orderLineNumber": "100",
            "serialNumbers": ["SN000000000001"]
          },
          {
            "lineNumber": "200",
            "quantity": 1,
            "orderLineNumber": "200",
            "serialNumbers": []
          }
        ]
      },
      {
        "billingId": "9800000001",
        "events": { "Billed": "2026-06-19T10:41:41.388+02:00" },
        "type": "CreditNote",
        "billingLine": [
          {
            "lineNumber": "100",
            "quantity": 1,
            "orderLineNumber": "100",
            "serialNumbers": ["SN000000000001"]
          }
        ]
      }
    ]
  }
}

Key points:

The credit note appears as an additional entry in billings — the original invoice is unchanged
A partial return results in a partial billingLine (only the returned lines)
The credit note has its own events.Billed timestamp
The order itself remains Completed — issuing a credit note does not change the order state

Line Types

Physical Item

Standard product. categories: ["PHYSICAL_ITEM"]. No nested orderLines.

Delivery / Shipping Fee

Shipping service attached to the order. categories: ["DELIVERY"]. No nested orderLines.

Bundle

A grouped set of items sold together. The parent line carries categories: ["VIRTUAL_ITEM"] and a price of 0.00. The individual component lines are nested inside orderLines with their real prices and categories: ["PHYSICAL_ITEM"].

Response — Bundle / sale set (2000100006)

{
  "order": {
    "orderId": "2000100006",
    "events": { "Placed": "2026-06-19T08:48:04.6270466+02:00" },
    "orderLines": [
      {
        "lineNumber": "100",
        "name": "Logitech MX Keys + MX Master Kombo",
        "materialNumber": "1000003",
        "quantity": { "total": 1, "fulfilled": 0, "cancelled": 0 },
        "unitPrice": { "gross": 0.0, "net": 0.0, "vat": 0.0 },
        "categories": ["VIRTUAL_ITEM"],
        "orderLines": [
          {
            "lineNumber": "101",
            "name": "Logitech MX Keys S Trådløst Tastatur",
            "materialNumber": "1000001",
            "quantity": { "total": 1, "fulfilled": 0, "cancelled": 0 },
            "unitPrice": { "gross": 544.99, "net": 435.99, "vat": 109.0 },
            "categories": ["PHYSICAL_ITEM"],
            "orderLines": []
          },
          {
            "lineNumber": "102",
            "name": "Logitech MX Master 3S Trådløs Mus",
            "materialNumber": "1000004",
            "quantity": { "total": 1, "fulfilled": 0, "cancelled": 0 },
            "unitPrice": { "gross": 255.01, "net": 204.01, "vat": 51.0 },
            "categories": ["PHYSICAL_ITEM"],
            "orderLines": []
          }
        ]
      },
      {
        "lineNumber": "200",
        "name": "Hjemlevering",
        "materialNumber": "2000002",
        "quantity": { "total": 1, "fulfilled": 0, "cancelled": 0 },
        "unitPrice": { "gross": 185.0, "net": 148.0, "vat": 37.0 },
        "categories": ["DELIVERY"],
        "orderLines": []
      }
    ]
  }
}

Key points:

The parent VIRTUAL_ITEM line always has unitPrice of 0.00 — it is a container, not a priced product
Real prices and quantities live on the nested child lines
expectedDeliveries and deliveries reference the child line numbers (101, 102), not the parent (100)

Service Add-On

A service or installation attached to a physical product. The parent line is a PHYSICAL_ITEM with its own price. Service child lines have categories: ["SERVICE"].

Response — Physical item with service add-on (2000100007)

{
  "order": {
    "orderId": "2000100007",
    "checkoutId": null,
    "events": { "Placed": "2023-09-12T14:48:16.59804+02:00" },
    "orderLines": [
      {
        "lineNumber": "100",
        "name": "KS iPhone 14 128GB Midnight",
        "materialNumber": "1000005",
        "quantity": { "total": 1, "fulfilled": 1, "cancelled": 0 },
        "unitPrice": { "gross": 10490.0, "net": 8392.0, "vat": 2098.0 },
        "categories": ["PHYSICAL_ITEM"],
        "orderLines": [
          {
            "lineNumber": "101",
            "name": "Montering av skjermbeskyttelse mobil",
            "materialNumber": "1000006",
            "quantity": { "total": 1, "fulfilled": 1, "cancelled": 0 },
            "unitPrice": { "gross": 100.0, "net": 80.0, "vat": 20.0 },
            "categories": ["SERVICE"],
            "orderLines": []
          },
          {
            "lineNumber": "102",
            "name": "Puro iPhone6 Bumper Cover Black",
            "materialNumber": "1000007",
            "quantity": { "total": 1, "fulfilled": 1, "cancelled": 0 },
            "unitPrice": { "gross": 100.0, "net": 80.0, "vat": 20.0 },
            "categories": ["PHYSICAL_ITEM"],
            "orderLines": []
          }
        ]
      },
      {
        "lineNumber": "200",
        "name": "Postnord Stykkgods",
        "materialNumber": "2000001",
        "quantity": { "total": 1, "fulfilled": 1, "cancelled": 0 },
        "unitPrice": { "gross": 131.25, "net": 105.0, "vat": 26.25 },
        "categories": ["DELIVERY"],
        "orderLines": []
      }
    ],
    "billings": [
      {
        "billingId": "9100000005",
        "events": { "Billed": "2023-09-20T23:09:08.871+02:00" },
        "type": "Invoice",
        "billingLine": [
          {
            "lineNumber": "100",
            "quantity": 1,
            "orderLineNumber": "100",
            "serialNumbers": ["SN000000000002"]
          },
          {
            "lineNumber": "101",
            "quantity": 1,
            "orderLineNumber": "101",
            "serialNumbers": []
          },
          {
            "lineNumber": "102",
            "quantity": 1,
            "orderLineNumber": "102",
            "serialNumbers": []
          },
          {
            "lineNumber": "200",
            "quantity": 1,
            "orderLineNumber": "200",
            "serialNumbers": []
          }
        ]
      }
    ]
  }
}

Key points:

The parent is a priced PHYSICAL_ITEM (not VIRTUAL_ITEM) — it has real quantity and price
Service child lines have their own price and appear in billing alongside the parent

Error Responses — `GET /orders/v1/{orderId}`

All errors share the same envelope shape. The code field identifies the error type.

400 — Validation Error

Returned when the request is malformed (e.g. empty or whitespace-only orderId).

{
  "errors": [
    { "fieldName": "OrderId", "message": "OrderId cannot be null or empty." }
  ],
  "code": "ERR_VALIDATION_0001",
  "traceId": "TRACE000000000001:00000001",
  "type": "https://<store-url>/swagger#Validation",
  "title": "Validation Failed",
  "status": 400,
  "detail": "Some fields have validation errors",
  "instance": "/orders/v1/%20",
  "extensions": {}
}

The errors[] array lists each invalid field with a human-readable message.

401 — Unauthorized

No response body. The request is missing or has an invalid Authorization header.

403 — Forbidden (no scope)

No response body. The token is valid but does not include the orders scope.

403 — Access Denied

Returned when the caller’s token is valid and scoped, but the order belongs to a different account.

{
  "code": "ERR_ACCESS",
  "traceId": "TRACE000000000002:00000001",
  "type": "https://<store-url>/swagger#AccessError",
  "title": "Access Denied",
  "status": 403,
  "detail": "You do not have access to this order.",
  "instance": "/orders/v1/2000100008",
  "extensions": {}
}

404 — Not Found

Returned when the orderId does not exist.

{
  "code": "ERR_NOTFOUND",
  "traceId": "TRACE000000000003:00000001",
  "type": "https://<store-url>/swagger#NotFound",
  "title": "Not Found",
  "status": 404,
  "detail": "Order not found.",
  "instance": "/orders/v1/non-existing-id",
  "extensions": {}
}

Orders Get by Id

Order Detail — GET /orders/v1/{orderId}

Order State

Order Lifecycle Examples

Open Order

In Progress — Partial Fulfillment

Completed — All Lines Fulfilled

Cancelled — Fully Cancelled

Partially Cancelled After Partial Fulfillment

Delivery Scenarios

Split Delivery

Collection Point

Billing

Invoice

Credit Note

Line Types

Physical Item

Delivery / Shipping Fee

Bundle

Service Add-On

Error Responses — GET /orders/v1/{orderId}

400 — Validation Error

401 — Unauthorized

403 — Forbidden (no scope)

403 — Access Denied

404 — Not Found

Order Detail — `GET /orders/v1/{orderId}`

Error Responses — `GET /orders/v1/{orderId}`