---
title: Get all Ad Groups
framework: Apple Ads
role: symbol
role_heading: Web Service Endpoint
platforms: [search ads 5.0+]
path: apple_ads/get-all-ad-groups
---

# Get all Ad Groups

Fetches all ad groups with a campaign identifier.

## URL

GET https://api.searchads.apple.com/api/v5/campaigns/{campaignId}/adgroups

## Path Parameters

campaignId: The unique identifier for the campaign.

## Query Parameters

limit: The number of items to return per request. The maximum is 1000 for most objects. offset: The offset pagination that limits the number of returned records. The start of each page is offset by the specified number.

## Response Codes

200 OK: If the call succeeds, the API returns the AdGroup object in the response payload with an HTTP status code of 200(OK). If unsuccessful, the HTTP status code indicates the error with details in the error message. 401 Unauthorized: An unauthenticated call fails to get the requested response. 403 Forbidden: Insufficient rights to the resource. 404 Not Found: The API can’t locate the resource. 429 : The API calls exceed rate-limit thresholds. See the Rate Limits subsection of Calling the Apple Ads API. 500 Internal Server Error: The Apple Ads server is temporarily down or unreachable. The request may be valid, but you need to retry it later.

## Discussion

Discussion To return all ad groups, use the associated campaignId and adgroupId in the URI path. You can also use a partial fetch. For more information, see the Use a Partial Fetch section of Using Apple Ads API Functionality.

## See Also

### Ad Group Endpoints

- [Create an Ad Group](apple_ads/create-an-ad-group.md)
- [Find Ad Groups](apple_ads/find-ad-groups.md)
- [Find Ad Groups (org-level)](apple_ads/find-ad-groups-(org-level).md)
- [Get an Ad Group](apple_ads/get-an-ad-group.md)
- [Update an Ad Group](apple_ads/update-an-ad-group.md)
- [Delete an Ad Group](apple_ads/delete-an-ad-group.md)