Cancel Order

DELETE /api/v1/orders/{id}

Cancel a pending order.

Path Parameters

Parameter	Type	Required	Description
id	string	Yes	The order ID

Headers

Header	Required	Description
X-API-Key	Yes	Your API key (starts with ek_)
Accept-Language	No	en (default) or ar

Responses

200 — Order canceled

{
  "id": "ord_abc123",
  "externalOrderId": "EO-12345",
  "customerName": "Ahmed Mohamed",
  "customerPhone": "201234567890",
  "customerAddress": "15 Tahrir St, Cairo",
  "subtotal": 150,
  "shippingCost": 25,
  "totalCost": 175,
  "currency": "EGP",
  "status": "pending",
  "customerAction": "approved",
  "deliveryStatus": "sent",
  "items": [
    {
      "id": "item_xyz789",
      "productName": "iPhone Case",
      "variantName": "Black / Large",
      "quantity": 2,
      "unitPrice": 75,
      "totalPrice": 150
    }
  ],
  "createdAt": "2026-04-20T10:23:52.772Z",
  "updatedAt": "2026-04-20T10:23:52.772Z"
}

404 — Order not found

{
  "success": false,
  "message": "Order not found",
  "error": "NOT_FOUND"
}

Try It

DELETEhttps://api.easyconfirm.net/api/v1/orders/{id}

{id}

X-API-Key *

HeaderValue

X-API-Key—

Example

curl -X DELETE https://api.easyconfirm.net/api/v1/orders/ord_abc123 \
  -H "X-API-Key: ek_your_api_key_here"