---
title: "Delete a purchase order"
method: DELETE
path: "/quickbooks-desktop/purchase-orders/{id}"
---

# Delete a purchase order

`DELETE /quickbooks-desktop/purchase-orders/{id}`

Permanently deletes a purchase order. The deletion will fail if the purchase order is currently in use or has any linked transactions that are in use.

## Path parameters

- `id` string, required — The QuickBooks-assigned unique identifier of the purchase order to delete.

## Headers

- `Conductor-End-User-Id` string, required — The ID of the End-User to receive this request.

## Response `200`

Returns a confirmation of the deletion with the ID of the deleted purchase order.

- object
  - `id` string, required — The QuickBooks-assigned unique identifier of the deleted purchase order.
  - `objectType` 'qbd_purchase_order', required — The type of object. This value is always `"qbd_purchase_order"`.
  - `refNumber` string, nullable, required — The case-sensitive user-defined reference number of the deleted purchase order.
  - `deleted` boolean, required — Indicates whether the purchase order was deleted.

## Changes

- **2026-05-02** `1de07095c4b7` — 1 warning
  - for the `path` request parameter `id`, the maxLength was set to `36`
- **2026-04-20** `10d4e9ebd1df` — 1 breaking
  - response property `refNumber` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
- **2026-04-20** `8e0b7df2044d` — 1 breaking, 1 info
  - the response property `refNumber` became nullable for the status `200`
  - response property `refNumber` list-of-types was narrowed by removing types `null` from media type `application/json` of response `200`
- **2026-04-20** `5f832f695675` — 1 breaking
  - response property `refNumber` list-of-types was widened by adding types `null` to media type `application/json` of response `200`

[Change history](https://skmtc.dev/conductor-is/apis/conductor-api/changes/quickbooks-desktop/purchase-orders/:id/delete.md)

---

[API](https://skmtc.dev/conductor-is/apis/conductor-api.md) · [All operations](https://skmtc.dev/conductor-is/apis/conductor-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/conductor-is/conductor-api/revisions/0b07b3ebe160/schema)
