---
title: SharedBudgetQueryResponse
framework: Apple Ads Platform API
role: symbol
role_heading: Object
platforms: [apple ads platform api 1.0+]
path: apple-ads-platform-api/sharedbudgetqueryresponse
---

# SharedBudgetQueryResponse

The response object for a budget order query.

## Declaration

```data
object SharedBudgetQueryResponse
```

## Properties

result: Array of SharedBudget objects matching the query filters. Omitted entirely on failure rather than returned as null. Read-only. pagination: Pagination metadata for the result set, including pageSize (number of results per page), offset (zero-based offset of the first result), and totalCount (total number of matching records, only populated when the request sends fetchTotalCount: true). Read-only. error: Error details if the request failed. Omitted entirely on success and never returned as "error": null. Only appears when the operation fails. See Error. Read-only.

## Discussion

Discussion The budget order query endpoint returns SharedBudgetQueryResponse, which contains the filtered, sorted, and paginated set of SharedBudget objects matching the request. The result array holds the matching records. To scope results by ad account ID, status, or specific budget IDs, use the QueryRequest body with filters. note: The underlying implementation is the generic QueryResponse<SharedBudget> envelope. This documentation uses the type name SharedBudgetQueryResponse for clarity. Example {   "result": [     {       "id": 777890001,       "name": "AwayFinder - Q3 2025 Budget",       "startTime": "2025-07-01T00:00:00.000",       "endTime": "2025-09-30T23:59:59.000",       "value": {         "amount": "20000.00",         "currency": "USD"       },       "adAccountIds": [         123456789       ],       "orgId": 555666777,       "systemStatus": "ACTIVE",       "systemStatusReasons": [],       "invoiceDetail": {         "primaryBuyerName": "Jordan Lee",         "primaryBuyerEmail": "jordan.lee@awayfinder.com",         "billingEmail": "billing@awayfinder.com",         "clientName": "AwayFinder Inc.",         "orderNumber": "PO-2025-Q3"       },       "creationTime": "2025-06-01T10:00:00.000",       "modificationTime": "2025-06-01T10:00:00.000",       "deleted": false     }   ],   "pagination": {     "pageSize": 20,     "offset": 0,     "totalCount": 1   } }

## See Also

- [SharedBudget](apple-ads-platform-api/sharedbudget.md)
- [SharedBudgetCreate](apple-ads-platform-api/sharedbudgetcreate.md)
- [SharedBudgetUpdate](apple-ads-platform-api/sharedbudgetupdate.md)
- [SharedBudgetResponse](apple-ads-platform-api/sharedbudgetresponse.md)
- [SharedBudgetAssignment](apple-ads-platform-api/sharedbudgetassignment.md)
- [SharedBudgetAssignmentCreate](apple-ads-platform-api/sharedbudgetassignmentcreate.md)
- [SharedBudgetAssignmentUpdate](apple-ads-platform-api/sharedbudgetassignmentupdate.md)
- [InvoiceDetail](apple-ads-platform-api/invoicedetail.md)
- [InvoiceDetailUpdate](apple-ads-platform-api/invoicedetailupdate.md)