Skip to main content

Delete Order

Delete an existing order.

HTTP Request

DELETE/api/orders/:id

Authorization

Authorization

  • Required: Yes
  • Permission: Staff or Admin
  • Authentication: Token-based (Authorization: Token <your_api_key>)

Path Parameters

ParameterTypeRequiredDescription
idIntegerYesUnique ID of the order to delete

Status Rules

We have some rules to delete an order. Look at the table below:

Current StatusCan be Deleted?
newYes
holdYes
failedYes
cancelledYes
processingNo
shippedNo
completedYes
refundedYes

Example Requests

1import requests
2
3response = requests.delete('http://www.example.com/api/orders/123', 
4  headers={'Authorization': 'Token <your_api_key>'}
5)
6print(response.status_code)  # Should be 204 for successful deletion

Status Codes

CodeDescription
204Order deleted successfully
401Unauthorized — authentication required
403Forbidden — insufficient permissions
404Not found — product does not exist
500Internal server error

Response Fields

FieldTypeDescription
NoneNoneNo response body returned