Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Permanently delete a new-status order. Orders that have progressed past new status must go through the cancel endpoint instead of delete.
new status — orders that have been picked up, are in transit, or have reached any other status must go through the cancel flow instead.
new can be deleted. If the order is in any other status, use POST /orders/{orderId}/cancel instead. Deletion is permanent and cannot be undone.| Requirement | Value |
|---|---|
| API key | Required (Authorization: Bearer nsk_live_...) |
| Scope | orders |
X-Merchant-Id | Required for company keys |
| Parameter | Type | Description |
|---|---|---|
orderId | string | The order’s MongoDB _id or the 6-digit orderNumber. Both are accepted. |
| Scenario | Action |
|---|---|
Order is in new status and you want to remove it entirely | DELETE /orders/{orderId} |
Order is past new status (e.g. inProgress, outForDelivery) | POST /orders/{orderId}/cancel |
curl -X DELETE "https://now.com.eg/api/public/v1/orders/482917" \
-H "Authorization: Bearer nsk_live_YOUR_KEY" \
-H "X-Merchant-Id: shop_123"
{
"success": true,
"data": {
"message": "Order deleted successfully."
}
}
new, the API returns a descriptive error:
{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "This order can no longer be deleted",
"details": {}
}
}
| HTTP status | Code | Cause |
|---|---|---|
400 | VALIDATION_ERROR | The order’s status is not new. Use POST /orders/{orderId}/cancel instead. |
401 | UNAUTHORIZED | API key is missing, invalid, or revoked. |
403 | SCOPE_DENIED | API key does not have the orders scope. |
403 | MERCHANT_REQUIRED | Company key used without X-Merchant-Id. |
403 | MERCHANT_NOT_FOUND | The merchant ID in X-Merchant-Id is not linked to your company. |
404 | NOT_FOUND | No order with the given orderId or orderNumber was found. |