# Delete a Budget Order Soft-deletes a budget order by its unique identifier. ## Discussion This endpoint soft-deletes the specified budget order. The system marks the record `deleted: true`, and it’s no longer available for assignment to campaigns. You must remove all campaign assignments before you can delete a budget order. ### Check deletion restrictions Deletion returns a `400 Bad Request` in the following cases: - The budget order has been canceled (status reason `CANCELED`). - The budget order has completed or expired (status reason `SCHEDULE_EXPIRED`). - The budget order is exhausted (status reason `EXHAUSTED`). - The budget order has already started (start time is in the past). - The budget order has campaigns currently assigned to it. Remove all campaign assignments first. Deleting an already-deleted budget order returns a `404 Not Found`. Deletion has different implications depending on what you’re trying to do next: |Scenario |Behavior | |------------------------------|-------------------------------------------------------------------------------------------------------------------| |Campaign assignments |You must remove them before deletion is allowed. A budget order with active campaign assignments cannot be deleted.| |Querying deleted budget orders|Include `deleted: EQUALS: true` in query filters to return deleted budget orders. | |Restoration |The API cannot restore soft-deleted budget orders. | |Re-creation |Create a new budget order with the same name and parameters if needed. | ## Payload Examples **Delete a Budget Order:** ### Request Deletes a budget order by its unique identifier. Remove all campaign assignments before issuing this request. A successful delete returns HTTP 200 with an empty response body. ``` DELETE https://api.ads.apple.com/v1/shared-budgets/777890001 ``` ### Response ```json {} ``` --- Copyright © 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)