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

# AdGroupQueryResponse

The response object for an ad group query, containing matched results and pagination metadata.

## Declaration

```data
object AdGroupQueryResponse
```

## Properties

result: The filtered, sorted, and paginated set of matching AdGroup objects. See AdGroup. Read-only. pagination: Pagination metadata for the response, including offset, pageSize, and totalCount, to support offset-based navigation through large result sets. See QueryPaginationResult. Read-only. error: Error information if the request encountered an error. See Error. Read-only.

## Discussion

Discussion The AdGroupQueryResponse object is returned by the ad group query endpoint. Use the QueryRequest body with filters to scope results to a specific campaign, status, or set of ad group IDs. Example {   "result": [     {       "id": 555666777,       "name": "AwayFinder - Broad Match",       "adAccountId": 123456789,       "campaignId": 444555666,       "startTime": "2025-09-01T08:00:00.000",       "endTime": null,       "pricingModel": "CPT",       "automatedKeywordsOptIn": true,       "status": "ENABLED",       "systemStatus": "RUNNING",       "systemStatusReasons": [],       "systemStatusLimitingReasons": [],       "automatedKeywordsRequired": false,       "displayStatus": "RUNNING",       "bidStrategy": {         "bidStrategyType": "MANUAL_CPT",         "bidStrategyGoal": "TAP",         "bid": {           "amount": "5.00",           "currency": "USD"         }       },       "targeting": null,       "creationTime": "2025-09-01T08:00:00.000",       "modificationTime": "2025-09-01T08:00:00.000",       "deleted": false,       "cpaCap": null     }   ],   "pagination": {     "offset": 0,     "pageSize": 20,     "totalCount": 1   } }

## See Also

- [AdGroup](apple-ads-platform-api/adgroup.md)
- [AdGroupCreate](apple-ads-platform-api/adgroupcreate.md)
- [AdGroupUpdate](apple-ads-platform-api/adgroupupdate.md)
- [AdGroupResponse](apple-ads-platform-api/adgroupresponse.md)
- [AdGroupTargeting](apple-ads-platform-api/adgrouptargeting.md)
- [AdGroupTargetingCreate](apple-ads-platform-api/adgrouptargetingcreate.md)
- [AdGroupTargetingUpdate](apple-ads-platform-api/adgrouptargetingupdate.md)
- [BidStrategy](apple-ads-platform-api/bidstrategy.md)
- [BidStrategyCreate](apple-ads-platform-api/bidstrategycreate.md)
- [BidStrategyUpdate](apple-ads-platform-api/bidstrategyupdate.md)
- [CPAGoal](apple-ads-platform-api/cpagoal.md)
- [CPAGoalCreate](apple-ads-platform-api/cpagoalcreate.md)
- [CPAGoalUpdate](apple-ads-platform-api/cpagoalupdate.md)
- [TargetingData](apple-ads-platform-api/targetingdata.md)
- [TargetingDataCreate](apple-ads-platform-api/targetingdatacreate.md)