---
title: Query Ad Groups
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-adgroups-query
---

# Query Ad Groups

Query ad groups using filters, sorting, and pagination.

## URL

POST https://api.ads.apple.com/v1/adgroups/query

## Header Parameters

X-Ap-Context:

## Response Codes

200 OK: 400 Bad Request: 401 Unauthorized: 403 Forbidden: 404 Not Found: 429 Too Many Requests: 500 Internal Server Error:

## Discussion

Discussion This endpoint queries ad groups using a standard QueryRequest body. Filter by campaignId to scope results to a specific campaign. An empty request body returns all non-deleted ad groups across all campaigns in the ad account with default pagination. Each result in the response includes the full targeting and bidStrategy nested objects, making this the primary endpoint for auditing ad group configuration at scale. See QueryFilterOperator for the full set of supported comparison operators. Filterable Fields  |  |  |  |   |  |  |  |   |  |  |  |   |  |  |  |   |  |  |  |   |  |  |  |   |  |  |  |   |  |  |  |  The request body is a QueryRequest composed of QueryFilter conditions and QuerySort directives (QuerySortOrder), controlled by QueryPagination. Payload Examples

## See Also

- [Create an Ad Group](apple-ads-platform-api/post-adgroups.md)
- [Get an Ad Group](apple-ads-platform-api/get-adgroups-_id_.md)
- [Update an Ad Group](apple-ads-platform-api/put-adgroups-_id_.md)
- [Delete an Ad Group](apple-ads-platform-api/delete-adgroups-_id_.md)