<!--
{
  "availability" : [
    "Search Ads: 5.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Apple_Ads",
  "identifier" : "/documentation/apple_ads/Get-a-Budget-Order",
  "metadataVersion" : "0.1.0",
  "role" : "Web Service Endpoint",
  "symbol" : {
    "kind" : "Web Service Endpoint",
    "modules" : [
      "Apple Ads"
    ],
    "preciseIdentifier" : "rest:apple_ads:get:v5-budgetorders-{}"
  },
  "title" : "Get a Budget Order"
}
-->

# Get a Budget Order

Fetches a specific budget order using a budget order identifier.

## Discussion

When you create a budget order through [Apple Ads Advanced](https://ads.apple.com), the system returns a budget order ID (`boId`) that you can use with to return details of a specific budget order for an organization or campaign group. Through the API, you can only fetch a budget order using Get a Budget Order or [`Get all Budget Orders`](/documentation/apple_ads/Get-all-Budget-Orders).

This call retrieves a specific assigned budget order for your organization. It also returns completed and canceled orders. Budget orders also return when you use the [`Create a Campaign`](/documentation/apple_ads/Create-a-Campaign) or [`Update a Campaign`](/documentation/apple_ads/Update-a-Campaign) endpoints.

### Payload example: Get a budget order

**Request:**

```
GET https://api.searchads.apple.com/api/v5/budgetorders/{boId}
```

**Response:**

```json
{
  "data": {
    "orgIds": [
      3761812
    ],
    "bo": {
      "id": 542370539,
      "name": "get a budget order example",
      "startDate": "2024-04-08T00:00:00.000",
      "endDate": "2024-04-09T23:59:59.999",
      "budget": {
        "amount": "2000",
        "currency": "USD"
      },
      "orderNumber": "2376542",
      "clientName": "Trip Trek",
      "primaryBuyerName": "Trip Trek",
      "primaryBuyerEmail": "buyer@triptrek.com",
      "billingEmail": "billing@triptrek.com",
      "status": "COMPLETED",
      "parentOrgId": 27154130,
      "supplySources": [
        "APPSTORE_PRODUCT_PAGES_BROWSE", 
        "APPSTORE_SEARCH_RESULTS",
        "APPSTORE_SEARCH_TAB", 
        "APPSTORE_TODAY_TAB"
      ]
    }
  },
  "pagination": null,
  "error": null
}
```

---

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)