GET {{merchantAPIEndpoint}}/orders

GET {{merchantAPIEndpoint}}/orders?page=1&itemsPerPage=10

{
  "params": {
    "page": 1,                     // Current page number
    "itemsPerPage": 10,            // Number of items returned per page
    "totalItems": 265,             // Total number of available orders
    "status": null,                // Order status filter (null = no filter applied)
    "dateFrom": "2020-01-01 00:00:00", // Start date for filtering orders
    "dateTo": "2025-10-14 10:24:00"    // End date for filtering orders
  },
  "orders": [
    {
      "id": "GR--3292--MER78",      // Merchant order reference
      "state": "return-canceled",  // Current order state
      "countryCode": "GR",         // Order country code
      "hasInvoice": false,         // Indicates whether an invoice exists
      "totalItemsAmount": 1000,    // Total amount of the order
      "createdAt": "2025-09-30 17:31:31", // Order creation timestamp
      "updatedAt": null,           // Last update timestamp (null if never updated)
      "customer": {
        "userId": 17,              // Internal customer identifier
        "email": "sarah@example.com", // Customer email address
        "phone": "425-222-45-76",  // Customer phone number
        "firstName": "Sarah",      // Customer first name
        "lastName": "Muller"       // Customer last name
      }
    },
    {
      "id": "GR--3291--MER78",      // Merchant order reference
      "state": "delivered-to-customer", // Current order state
      "countryCode": "GR",         // Order country code
      "hasInvoice": false,         // Indicates whether an invoice exists
      "totalItemsAmount": 1000,    // Total amount of the order
      "createdAt": "2025-09-30 17:23:14", // Order creation timestamp
      "updatedAt": null,           // Last update timestamp
      "customer": {
        "userId": 17,              // Internal customer identifier
        "email": "sarah@example.com", // Customer email address
        "phone": "425-222-45-76",  // Customer phone number
        "firstName": "Sarah",      // Customer first name
        "lastName": "Muller"       // Customer last name
      }
    }
    // More orders can be listed here...
  ]
}

GET {{merchantAPIEndpoint}}/orders/{orderId}

{
  "id": "GR--3001--MER78",               // Merchant order reference
  "state": "picked-by-courier",         // Current order state
  "countryCode": "GR",                  // Country code where the order was placed
  "hasInvoice": false,                  // Indicates whether an invoice exists
  "subTotalItemsAmount": 2346,          // Sum of line item prices (before additional charges)
  "totalItemsAmount": 2746,             // Final order amount
  "createdAt": "2024-11-05 15:27:04",   // Order creation timestamp
  "updatedAt": null,                    // Last update timestamp (null if never updated)
  "expiresAt": null,                    // Order expiration timestamp (if applicable)
  "dispatchUntil": null,                // Latest allowed dispatch time
 
  "customer": {
    "userId": 0,                        // Internal customer identifier (0 = guest)
    "email": "maria.williams@example.com", // Customer email address
    "phone": null,                     // Customer phone number (if provided)
    "firstName": "Maria",              // Customer first name
    "lastName": "Williams"             // Customer last name
  },
 
  "addressDetails": {
    "street": "Aiolou",                // Street name
    "streetNumber": "24",              // Street number
    "postCode": "10552",                // Postal code
    "city": "Athens",                  // City
    "region": "ATTICA",                // Region name
    "regionCode": "ATT",               // Region code
    "country": "Greece",               // Country name
    "countryCode": "GR"                // Country ISO code
  },
 
  "invoiceDetails": null,               // Invoice details (null if no invoice issued)
 
  "carrier": {
    "shipmentId": 88,                  // Shipment identifier
    "name": "Courier Center",           // Courier company name
    "deliveryName": "Box Now",          // Delivery service name
    "deliveryKey": "courier_center_box_now", // Internal delivery method key
    "trackingCodes": "013742332791",    // Shipment tracking code(s)
    "comments": null,                  // Optional delivery comments
    "deliveryToCourierEstimationDate": null, // Estimated pickup date by courier
    "deliveryToCustomerEstimationDate": null // Estimated delivery date to customer
  },
 
  "payment": {
    "name": "cod"                      // Payment method (e.g. cod, credit_card)
  },
 
  "lineItems": [
    {
      "id": 310,                       // Line item identifier
      "sku": "SF-5",                   // Product SKU
      "merchantEan": "sf-foo-bar-9",   // Merchant EAN
      "merchantSku": "MERSKU9",        // Merchant SKU
      "productName": "Fashion Product Second", // Product name
      "unitPrice": 2346,               // Unit price
      "originalUnitPrice": 2346,       // Original unit price before discounts
      "totalPrice": 2346,              // Total price for this line item
      "quantity": 1,                   // Quantity ordered
      "sfArticle39Valid": false,       // Business rule flag
      "giftWrap": false,               // Gift wrap indicator
      "extendedAttributes": []         // Additional attributes (can be empty)
    }
 
    // Additional line items may follow...
  ]
}

{
	"error": {
		"code": "10301",
		"message": "The order with id {oderId} was not found"
	}
}

PATCH {{merchantAPIEndpoint}}/orders/{orderId}/accept

{
	"success": true
}

{
	"error": {
		"code": "10304",
		"message": "Cannot Accept Order"
	}
}

PATCH {{merchantAPIEndpoint}}/orders/{orderId}/reject

{
    "status":"D",
    "reason": "damaged" // optional
}

{
	"success": true
}

{
	"error": {
		"code": "10304",
		"message": "Cannot Reject Order"
	}
}

{
    "error": {
        "code": "10301",
        "message": "The reason is not valid"
    }
}