Order object

Seller API v1 · Updated 7 November 2026

An order as the API returns it: your store's parcel. Money is in your store's currency, as strings with two decimals.

Fields

Field	Type	Description
number	string	The order number.
status	string	paid, packed, shipped, delivered, received, disputed, cancelled or refunded.
ship_by	string	The date it must ship by.
ship_to	object	The delivery address.
totals	object	Items, shipping, klodivo's fee and any discount.
items	array	What was bought, with your external_ref.
carrier	string	Set once shipped, with tracking_no.

Still stuck? Contact us; we reply within 2 business days.

Previous Listing object

Example

{
  "number": "KL-2026-004127",
  "status": "paid",
  "paid_at": "2026-11-02T08:41:10Z",
  "ship_by": "2026-11-04",
  "buyer": {
    "name": "Sam de Vries",
    "country": "NL"
  },
  "ship_to": {
    "full_name": "Sam de Vries",
    "line1": "Oudegracht 112",
    "postal_code": "3511 AX",
    "city": "Utrecht",
    "country": "NL"
  },
  "shipping_service": "PostNL, tracked",
  "buyer_note": null,
  "totals": {
    "items": "24.50",
    "shipping": "4.95",
    "klodivo_fee": "0.61",
    "currency": "EUR",
    "discount": "0.00",
    "discount_code": null
  },
  "carrier": null,
  "tracking_no": null,
  "shipped_at": null,
  "expected_delivery": null,
  "items": [
    {
      "listing_id": 48213,
      "external_ref": "A1-6080",
      "item_no": "6080-1",
      "name": "King's Castle",
      "condition": "Used, good",
      "color": null,
      "quantity": 1,
      "unit_price": "24.50"
    }
  ]
}