Delete an Item

Delete an Item using this endpoint.

DELETE /v1/items/:id

Curl

curl -u [YOUR_KEY_ID]:[YOUR_KEY_SECRET] \
  -X DELETE https://api.razorpay.com/v1/items/item_7Oy8OMV6BdEAac \

Success

[]

Available in🇮🇳 India🇺🇸 United States

Use this endpoint to delete an item.

Curl

curl -u [YOUR_KEY_ID]:[YOUR_KEY_SECRET] \
  -X DELETE https://api.razorpay.com/v1/items/item_7Oy8OMV6BdEAac \

Success

[]

Path Parameters

id · string · required

The unique identifier of the item that must be deleted.

Errors

The API `<key/secret> ` provided is invalid.

Code: 4xx

The API key or secret are not entered or an invalid API key is used.

Solution: Use and enter the correct API details while executing the API.

The id provided does not exist.

Code: 400

The invoice id entered is either invalid or does not belong to the requester account.

Solution: Enter a valid invoice id.

Delete operation not allowed for item of type: {type}.

Code: 400

The item id passed belongs to a non-invoice item type (for example, payment_page). Only items of type invoice can be deleted through this endpoint.

Solution: Confirm the item’s type using the Fetch Item API. Only invoice-type items support deletion via DELETE /v1/items/:id.

Cannot delete an item with which invoices have been created already.

Code: 400

The item has already been associated with one or more invoices. Razorpay does not allow deleting items that have a history of use, to preserve invoice integrity.

Solution: Mark the item as inactive instead by calling PATCH /v1/items/:id with active: false. Inactive items remain available on past invoices but cannot be used on new ones.