<!--
{
  "availability" : [
    "Apple Ads Platform API: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Apple-Ads-Platform-API",
  "identifier" : "/documentation/Apple-Ads-Platform-API/GET-shared-budgets-_id_",
  "metadataVersion" : "0.1.0",
  "role" : "Web Service Endpoint",
  "symbol" : {
    "kind" : "Web Service Endpoint",
    "modules" : [
      "Apple Ads Platform API"
    ],
    "preciseIdentifier" : "rest:apple-ads-platform-api:get:shared-budgets-{}"
  },
  "title" : "Get a Budget Order by ID"
}
-->

# Get a Budget Order by ID

Retrieves a single budget order by its ID.

## Discussion

This endpoint retrieves the full details of a specific budget order by its ID. The response includes the budget order’s value, active date range, assigned ad accounts, and invoice details.

## Payload Examples

**Get a Budget Order by ID:**

### Request

Retrieves the full details of a specific budget order by its ID.

```
GET https://api.ads.apple.com/v1/shared-budgets/777888999
```

### Response

```json
{
 "result": {
   "id": 777888999,
   "orgId": 100456789,
   "name": "AwayFinder - Q1 2025 Budget",
   "startTime": "2025-01-01T00:00:00.000",
   "endTime": "2025-03-31T23:59:59.000",
   "value": {
     "amount": "10000.00",
     "currency": "USD"
   },
   "adAccountIds": [
     123456789
   ],
   "systemStatus": "ACTIVE",
   "systemStatusReasons": [],
   "invoiceDetail": {
     "primaryBuyerName": "Jane Smith",
     "primaryBuyerEmail": "jane.smith@awayfinder.com",
     "billingEmail": "billing@awayfinder.com"
   },
   "deleted": false,
   "creationTime": "2025-01-01T00:00:00.000",
   "modificationTime": "2025-01-01T00:00:00.000"
 }
}
```

---

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)