---
title: BudgetOrder
framework: Apple Ads
role: symbol
role_heading: Object
platforms: [search ads 2.0+]
path: apple_ads/budgetorder
---

# BudgetOrder

The response to requests for budget order details.

## Declaration

```data
object BudgetOrder
```

## Properties

billingEmail: The billing email. This field is updatable. budget: The total budget amount available for the budget order. This field is updatable. clientName: The advertiser or product. This is a requirement for agency-type accounts. This field is updatable only before the startDate of a campaign. endDate: The scheduled end date and time for the budget order in the format of yyyy-mm-dd'T'HH:MM:SS.SSS. This field is updatable. id: A unique identifier for the budget order. When you create a budget order through Apple Ads Advanced, the system returns a budget order ID (boId) that you can use with Get a Budget Order to return details of a specific budget order for an organization or campaign group. name: The name of the budget order, which is unique within an organization. This field is updatable only before the startDate of a campaign. orderNumber: A purchase order number. This is a requirement for agency-type accounts. This field is updatable only before the startDate of a campaign. parentOrgId: The unique identifier of the organization that owns the budget order. primaryBuyerEmail: The primary buyer’s email address. This field is updatable. primaryBuyerName: The primary buyer’s name. This field is updatable. startDate: The scheduled start date and time for the budget order in the format of yyyy-mm-dd'T'HH:MM:SS.SSS. This field is updatable only before the startDate of a campaign and is only editable if there are no campaigns assigned to the budget order. status: The system-controlled status indicator for the budget order. supplySources: The supply source of ads to use in a budget order and a campaign. As of 5.3, the Create a Budget Order endpoint does not support a single placement type. In all responses, the supplySources field contains all possible values.

## See Also

### Budget Order Request and Response Objects

- [BudgetOrderInfo](apple_ads/budgetorderinfo.md)
- [BudgetOrderCreate](apple_ads/budgetordercreate.md)
- [BudgetOrderUpdate](apple_ads/budgetorderupdate.md)
- [BudgetOrderInfoResponse](apple_ads/budgetorderinforesponse.md)
- [BudgetOrderInfoListResponse](apple_ads/budgetorderinfolistresponse.md)
- [LOCInvoiceDetails](apple_ads/locinvoicedetails.md)
- [Money](apple_ads/money.md)