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

# QueryRequest

The standard request body used across all query endpoints, supporting filters, sorting, pagination, and field selection.

## Declaration

```data
object QueryRequest
```

## Properties

filters: Filter field conditions. If no filters are in the request, all non-deleted entities within the current ad account scope are returned. Deleted entities aren’t returned unless specified to be included. See QueryFilter. sorting: Sort entities in ascending or descending order. The default behavior is to sort by ID, ascending. See QuerySort. pagination: Controls pagination settings for results using offset and size. See QueryPagination.

## Discussion

Discussion The QueryRequest object is the standard request body used across all query endpoints in the Apple Ads Platform API. To filter on fields marked Filterable in each entity’s dictionary keys, use QueryFilter entries. The query combines multiple filters with logical AND. Example {   "filters": [     {       "field": "name",       "operator": "CONTAINS_ANY",       "value": ["AwayFinder", "AwayFinder Promo"],       "ignoreCase": true     }   ],   "sorting": [     {       "field": "id",       "order": "DESC"     }   ],   "pagination": {     "pageSize": 25,     "offset": 0,     "fetchTotalCount": true   } }

## See Also

### Query Objects

- [QueryFilter](apple-ads-platform-api/queryfilter.md)
- [QuerySort](apple-ads-platform-api/querysort.md)
- [QueryPagination](apple-ads-platform-api/querypagination.md)
- [QueryResponse](apple-ads-platform-api/queryresponse.md)
- [QueryPaginationResult](apple-ads-platform-api/querypaginationresult.md)