---
title: Query Budget Orders
framework: Apple Ads Platform API
role: symbol
role_heading: Web Service Endpoint
platforms: [apple ads platform api 1.0+]
path: apple-ads-platform-api/post-shared-budgets-query
---

# Query Budget Orders

Returns a filtered, sorted, and paginated list of budget orders.

## URL

POST https://api.ads.apple.com/v1/shared-budgets/query

## Header Parameters

X-Ap-Context:

## Response Codes

200 OK: Successful operation. Returns SharedBudgetQueryResponse (result: array of SharedBudget). 400 Bad Request: Bad Request. Returns ErrorResponse. 401 Unauthorized: Unauthorized. 403 Forbidden: Forbidden. 404 Not Found: Resource not found. Returns ErrorResponse. 429 Too Many Requests: Rate Limit Exceeded. See Applying Rate Limits. 500 Internal Server Error: Internal Server Error. Returns ErrorResponse.

## Discussion

Discussion This endpoint finds budget orders by name, status, or date range, or retrieves them across an ad account. Narrow and order the result set with filters, sorting, and pagination. See QueryFilterOperator for the full set of supported comparison operators. Filterable Fields  |  |  |  |   |  |  |  |   |  |  |  |   |  |  |  |   |  |  |  |   |  |  |  |   |  |  |  |   |  |  |  |   |  |  |  |   |  |  |  |   |  |  |  |   |  |  |  |  The value and invoiceDetail fields aren’t filterable. The request body is a QueryRequest composed of QueryFilter conditions and QuerySort directives (QuerySortOrder), controlled by QueryPagination. Payload Examples

## See Also

- [Get a Budget Order by ID](apple-ads-platform-api/get-shared-budgets-_id_.md)
- [Create a Budget Order](apple-ads-platform-api/post-shared-budgets.md)
- [Update a Budget Order](apple-ads-platform-api/put-shared-budgets-_id_.md)
- [Delete a Budget Order](apple-ads-platform-api/delete-shared-budgets-_id_.md)