---
title: Delete a Budget Order
framework: Apple Ads Platform API
role: symbol
role_heading: Web Service Endpoint
platforms: [apple ads platform api 1.0+]
path: apple-ads-platform-api/delete-shared-budgets-_id_
---

# Delete a Budget Order

Soft-deletes a budget order by its unique identifier.

## URL

DELETE https://api.ads.apple.com/v1/shared-budgets/{id}

## Path Parameters

id:

## Response Codes

200 OK: 400 Bad Request: 401 Unauthorized: 403 Forbidden: 404 Not Found: 429 Too Many Requests: 500 Internal Server Error:

## Discussion

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:  |   |   |   |   |  Payload Examples

## See Also

- [Get a Budget Order by ID](apple-ads-platform-api/get-shared-budgets-_id_.md)
- [Create a Budget Order](apple-ads-platform-api/post-shared-budgets.md)
- [Query Budget Orders](apple-ads-platform-api/post-shared-budgets-query.md)
- [Update a Budget Order](apple-ads-platform-api/put-shared-budgets-_id_.md)