Delete Order Item

Delete an existing order item.

HTTP Request

DELETE/api/orders/:id/items/:item_id

Authorization

Authorization

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

Path Parameters

Parameter	Type	Required	Description
id	Integer	Yes	Unique ID of the order to delete
item_id	Integer	Yes	Unique ID of the order item to delete

Example Requests

🐍 Python

1import requests
2
3response = requests.delete('http://www.example.com/api/orders/123/items/789', 
4  headers={'Authorization': 'Token <your_api_key>'}
5)
6print(response.json())

🌐 Curl

1curl -X DELETE "http://www.example.com/api/orders/123/items/789" -H "Authorization: Token <your_api_key>"

Response Fields

Field	Type	Description
id	Integer	Unique ID of the order
key	String	Unique key of the order (read-only)
status	String	Current status of the order
customer_data	Object	Customer information (read-only)
payment_method_data	Object	Payment method information (read-only)
shipping_method_data	Object	Shipping method information (read-only)
shipping_cost	Number	Cost of shipping
notes	String	Order notes
extra	Object	Additional order data
created_at	String (ISO 8601)	Timestamp when order was created
updated_at	String (ISO 8601)	Timestamp when order was last updated
billing_country_data	Object	Billing country information (read-only)
billing_state_data	Object	Billing state information (read-only)
billing_city_data	Object	Billing city information (read-only)
billing_address	String	Billing address
billing_postal_code	String	Billing postal code
billing_national_code	String	Billing national code
billing_mobile_number	String	Billing mobile number
billing_first_name	String	Billing first name
billing_last_name	String	Billing last name
count	Integer	Number of items in order (computed field)
quantity	Integer	Total quantity of items (computed field)
items_subtotal	Number	Subtotal of all items (computed field)
items_discount	Number	Total discount on items (computed field)
subtotal	Number	Order subtotal (computed field)
total_discount	Number	Total discount amount (computed field)
total	Number	Order total amount (computed field)
amount_paid	Number	Amount already paid (computed field)
amount_outstanding	Number	Outstanding amount (computed field)
is_paid	Boolean	Whether order is fully paid (computed field)
items	Array	List of order items (read-only)
payments	Array	List of order payments (read-only)

Customer Structure

The customer object contains:

Field	Type	Description
id	Integer	Customer ID
username	String	Customer username
mobile_number	String	Customer mobile number
first_name	String	Customer first name
last_name	String	Customer last name
full_name	String	Customer full name (computed)

Payment Method Structure

The payment_method object contains:

Field	Type	Description
id	Integer	Payment method ID
name	String	Payment method name
image	Object	Payment method image data

Shipping Method Structure

The shipping_method object contains:

Field	Type	Description
id	Integer	Shipping method ID
name	String	Shipping method name
image	Object	Shipping method image data

Geographic Data Structures

Country, state, and city objects contain:

Country/State:

Field	Type	Description
id	Integer	Location ID
name	String	Location name
code	String	Location code

City:

Field	Type	Description
id	Integer	City ID
name	String	City name

Order Items Structure

Each item in the items array contains:

Field	Type	Description
id	Integer	Unique ID of the order item
product	Integer	Unique ID of the product
product_name	String	Current Product Name
product_data	JsonField	Snapshot of product data at time of order
unit_price	Integer	Price per unit (in smallest currency unit)
unit_discount	Integer	Discount per unit (in smallest currency unit)
quantity	Integer	Quantity ordered
notes	String	Item-specific notes
subtotal	Integer	Calculated subtotal (computed field)
discount	Integer	Total discount for this item (computed field)
total	Integer	Final total for this item (computed field)
created_at	String (ISO 8601)	Item creation timestamp
updated_at	String (ISO 8601)	Item last update timestamp

Order Payment Structure

Each item in the payments array contains:

• The shipping method structure here is the same as the above-mentioned ShippingMethod Structure.

Field	Type	Description
id	Integer	Id of the order payment
payment_method_data	Object	Payment method data of the order payment
approved	Boolean	Whether the order payment is approved
amount	Integer	The order payment amount
transaction_id	String	The transaction id of the order payment
notes	String	The extra notes about the order payment
created_at	String (ISO 8601)	The creation datetime of the order payment
updated_at	String (ISO 8601)	The last updated datetime of the order payment

Example Response

{
    "id": 2,
    "key": "0c86ab758d3e236cb5a4",
    "status": "shipped",
    "customer_data": {
        "id": 1,
        "username": "BehroozGhorbani",
        "mobile_number": "09308744204",
        "first_name": "بهروز",
        "last_name": "قربانی",
        "full_name": "بهروز قربانی"
    },
    "payment_method_data": {
        "id": 1,
        "name": "پرداخت در مخل",
        "image": null
    },
    "shipping_method_data": {
        "id": 1,
        "name": "پیک موتور",
        "image": {
            "id": 8,
            "type": "image",
            "name": "پیک موتوری",
            "size": 808754,
            "human_readable_size": "789.80 KB",
            "f": "http://127.0.0.1:8000/media/core_media/2025/12/20/Fantasticheskie_kartinki_dlja_monitora_68_63.jpg",
            "width": 1920,
            "height": 1080,
            "mode": "RGB"
        }
    },
    "shipping_cost": 75000,
    "notes": "Facilis sequi alias optio. Alias ipsam deserunt. At veniam nam et. Et aut id id aut quae non animi. Sed tempora aut ut ipsa dicta vel eveniet et aspernatur.",
    "extra": {
        "some": "data"
    },
    "created_at": "2025-12-27T18:17:09.771123Z",
    "updated_at": "2025-12-28T11:28:47.290350Z",
    "billing_country_data": {
        "id": 1,
        "name": "ایران",
        "code": "IR"
    },
    "billing_state_data": {
        "id": 1,
        "name": "آذربایجان شرقی",
        "code": "EA"
    },
    "billing_city_data": {
        "id": 1,
        "name": "اسکو"
    },
    "billing_address": "5411 Stokes Grove",
    "billing_postal_code": "1234567890",
    "billing_national_code": null,
    "billing_mobile_number": "09523296536",
    "billing_first_name": "پدرام",
    "billing_last_name": "زمانی",
    "count": 0,
    "quantity": 0,
    "items_subtotal": 0,
    "items_discount": 0,
    "subtotal": 0,
    "total_discount": 0,
    "total": 75000,
    "amount_paid": 500000,
    "amount_outstanding": -425000,
    "is_paid": true,
    "is_payable": true,
    "items": [],
    "payments": [
        {
            "id": 1,
            "payment_method_data": {
                "id": 1,
                "name": "پرداخت در مخل",
                "image": null
            },
            "approved": true,
            "amount": 500000,
            "transaction_id": "1589800",
            "notes": "",
            "created_at": "2025-12-28T10:43:38.509103Z",
            "updated_at": "2025-12-28T10:43:38.509107Z"
        }
    ]
}

Notes

• Deletion here returns a 200 OK response with the whole order instance data