Budget Orders Endpoints
Create, retrieve, update, and delete budget orders through these endpoints.
Overview
Budget orders are available to Apple Ads customers that are on monthly invoicing. Budget orders work in addition to your daily budget 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. 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 and check the AdAccount.PaymentModel field in the 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 |
|---|---|---|
|
| Creates a new budget order via Post Shared Budgets. |
|
| Retrieves budget orders that match specified filters via Post Shared Budgets Query. |
|
| Retrieves a single budget order by its ID via Get Shared Budgets _id_. |
|
| Updates a budget order via Put Shared Budgets _id_. |
|
| Deletes a budget order by its ID via Delete Shared Budgets _id_. |