<!--
{
  "availability" : [
    "Apple Ads Platform API: 1.0.0 -"
  ],
  "documentType" : "article",
  "framework" : "Apple-Ads-Platform-API",
  "identifier" : "/documentation/Apple-Ads-Platform-API/budget-orders-endpoints",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Budget Orders Endpoints"
}
-->

# Budget Orders Endpoints

Create, retrieve, update, and delete budget orders through these endpoints.

## Overview

Budget orders are available to [Apple Ads](https://ads.apple.com/) customers that are on [monthly invoicing](https://ads.apple.com/help/billing/0031-monthly-invoicing). Budget orders work in addition to your [daily budget](https://ads.apple.com/app-store/help/bids-and-budget/0016-manage-budgets) to help you control costs. With a budget order, you can cap your total spend across campaigns in a campaign group set up through Apple Ads.

To use budget orders, an ad account must have a `LOC` (Line of Credit) `paymentModel`. In the API, Line of Credit (`LOC`) invoicing details are in [`InvoiceDetail`](/documentation/Apple-Ads-Platform-API/InvoiceDetail). If you don’t have a billing model set up, campaigns default to Pay as You Go (`PAYG`) and budget orders aren’t available.

To confirm your payment model, call [`Get Ad Account by ID`](/documentation/Apple-Ads-Platform-API/GET-ad-accounts-_id_) and check the [`AdAccount.PaymentModel`](/documentation/Apple-Ads-Platform-API/AdAccount/PaymentModel-data.typealias) field in the [`AdAccount`](/documentation/Apple-Ads-Platform-API/AdAccount) response object. If you don’t have a payment model set up, you can still create campaigns, but you need to select a payment model before a campaign is eligible to run.

## Call the Budget Orders Endpoints

Use the following endpoints to create, retrieve, update, and delete budget orders:

|Method  |Path                      |Description                                                                                                                                                      |
|--------|--------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------|
|`POST`  |`/v1/shared-budgets`      |Creates a new budget order via <doc://com.apple.apple-ads-platform-api/documentation/Apple-Ads-Platform-API/POST-shared-budgets>.                                |
|`POST`  |`/v1/shared-budgets/query`|Retrieves budget orders that match specified filters via <doc://com.apple.apple-ads-platform-api/documentation/Apple-Ads-Platform-API/POST-shared-budgets-query>.|
|`GET`   |`/v1/shared-budgets/{id}` |Retrieves a single budget order by its ID via <doc://com.apple.apple-ads-platform-api/documentation/Apple-Ads-Platform-API/GET-shared-budgets-_id_>.             |
|`PUT`   |`/v1/shared-budgets/{id}` |Updates a budget order via <doc://com.apple.apple-ads-platform-api/documentation/Apple-Ads-Platform-API/PUT-shared-budgets-_id_>.                                |
|`DELETE`|`/v1/shared-budgets/{id}` |Deletes a budget order by its ID via <doc://com.apple.apple-ads-platform-api/documentation/Apple-Ads-Platform-API/DELETE-shared-budgets-_id_>.                   |

## Topics

[`Get a Budget Order by ID`](/documentation/Apple-Ads-Platform-API/GET-shared-budgets-_id_)

[`Create a Budget Order`](/documentation/Apple-Ads-Platform-API/POST-shared-budgets)

[`Query Budget Orders`](/documentation/Apple-Ads-Platform-API/POST-shared-budgets-query)

[`Update a Budget Order`](/documentation/Apple-Ads-Platform-API/PUT-shared-budgets-_id_)

[`Delete a Budget Order`](/documentation/Apple-Ads-Platform-API/DELETE-shared-budgets-_id_)


---

Copyright &copy; 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)