---
title: Find Ad Groups (org-level)
framework: Apple Ads
role: symbol
role_heading: Web Service Endpoint
platforms: [search ads 5.0+]
path: apple_ads/find-ad-groups-(org-level)
---

# Find Ad Groups (org-level)

Fetches ad groups within an organization.

## URL

POST https://api.searchads.apple.com/api/v5/adgroups/find

## Response Codes

200 OK: Use this endpoint to find ad groups within your organization. Use a Selector Condition to narrow results. If you don’t specify selector conditions, all of your ad groups return in the API response. See the AdGroup object for field descriptions and selector condition operators. 400 Bad Request: An invalid query or missing required parameters. 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.

## Mentioned in

Apple Ads Campaign Management API 4

## Discussion

Discussion Use this endpoint to find ad groups within your organization. Use a Selector Condition to narrow results. If you don’t specify selector conditions, all of your ad groups return in the API response. See the AdGroup object for field descriptions and selector condition operators. Payload example: Find ad groups (org-level)

## HTTP Body

The request body that includes the selector Condition. Selector objects define what data the API returns when fetching resources.

## 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)
- [Get an Ad Group](apple_ads/get-an-ad-group.md)
- [Get all Ad Groups](apple_ads/get-all-ad-groups.md)
- [Update an Ad Group](apple_ads/update-an-ad-group.md)
- [Delete an Ad Group](apple_ads/delete-an-ad-group.md)