<!--
{
  "availability" : [
    "Apple Ads Platform API: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Apple-Ads-Platform-API",
  "identifier" : "/documentation/Apple-Ads-Platform-API/GET-adgroups-_id_",
  "metadataVersion" : "0.1.0",
  "role" : "Web Service Endpoint",
  "symbol" : {
    "kind" : "Web Service Endpoint",
    "modules" : [
      "Apple Ads Platform API"
    ],
    "preciseIdentifier" : "rest:apple-ads-platform-api:get:adgroups-{}"
  },
  "title" : "Get an Ad Group"
}
-->

# Get an Ad Group

Retrieve a single ad group by its unique identifier.

## Discussion

This endpoint retrieves a single ad group by its ID. The response includes all fields set at creation and any values modified since, including the full `targeting` and `bidStrategy` nested objects.

The response includes the following status fields:

|Field          |Type  |Description                                                                                                                                       |
|---------------|------|--------------------------------------------------------------------------------------------------------------------------------------------------|
|`status`       |string|Advertiser-managed state: `ENABLED` or `PAUSED`.                                                                                                  |
|`systemStatus` |string|System-computed: `RUNNING` or `NOT_RUNNING`. When `NOT_RUNNING`, inspect `systemStatusReasons`.                                                   |
|`displayStatus`|string|System-computed, rolled-up delivery state. See <doc://com.apple.apple-ads-platform-api/documentation/Apple-Ads-Platform-API/AdGroupDisplayStatus>.|

Keep the following constraints in mind when reading a GET response:

|Constraint                     |Detail                                                                                                          |
|-------------------------------|----------------------------------------------------------------------------------------------------------------|
|Deleted ad groups are returned |The API returns a deleted ad group with `deleted: true` and does not remove the record from GET by ID responses.|
|`campaignId` is always returned|The parent campaign ID is always present in the response.                                                       |
|Use query endpoint for listing |`GET /adgroups/{id}` returns a single record. Use `POST /adgroups/query` to filter and list multiple ad groups. |

## Payload Examples

**App Store Ad Group:**

### Request

Retrieves an App Store ad group by its unique identifier. This example shows a standard targeting ad group with device and age targeting.

```
GET https://api.ads.apple.com/v1/adgroups/555666777
```

### Response

```json
{
 "result": {
   "id": 555666777,
   "name": "AwayFinder iOS — New Users 18-34",
   "adAccountId": 123456789,
   "campaignId": 444555666,
   "pricingModel": "CPT",
   "status": "ENABLED",
   "systemStatus": "RUNNING",
   "displayStatus": "RUNNING",
   "startTime": "2025-09-01T00:00:00.000",
   "endTime": "2025-12-31T23:59:59.000",
   "targeting": {
     "deviceClass": {
       "include": [
         "IPHONE"
       ]
     },
     "minAge": {
       "include": [
         "18"
       ]
     },
     "maxAge": {
       "include": [
         "34"
       ]
     },
     "appDownloader": {
       "include": [
         "123456789"
       ]
     }
   },
   "automatedKeywordsOptIn": false,
   "deleted": false,
   "creationTime": "2025-01-10T08:00:00.000",
   "modificationTime": "2025-01-10T08:00:00.000"
 }
}
```

**Apple Maps Ad Group:**

### Request

Retrieves an Apple Maps ad group by its unique identifier. This example shows an ad group targeting Apple Maps.

```
GET https://api.ads.apple.com/v1/adgroups/555666779
```

### Response

```json
{
 "result": {
   "id": 555666779,
   "name": "AwayFinder Maps — Nearby Search",
   "adAccountId": 123456789,
   "campaignId": 444555668,
   "pricingModel": "CPT",
   "status": "ENABLED",
   "systemStatus": "RUNNING",
   "displayStatus": "RUNNING",
   "startTime": "2025-09-01T00:00:00.000",
   "endTime": "2025-12-31T23:59:59.000",
   "bidStrategy": {
     "bidStrategyType": "MANUAL_CPT",
     "bidStrategyGoal": "TAP",
     "bid": {
       "amount": "5.00",
       "currency": "USD"
     }
   },
   "targeting": {
     "radius": {
       "include": [
         "MEDIUM"
       ]
     }
   },
   "automatedKeywordsOptIn": false,
   "deleted": false,
   "creationTime": "2025-01-10T08:00:00.000",
   "modificationTime": "2025-01-10T08:00:00.000"
 }
}
```

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)