<!--
{
  "availability" : [
    "Apple Ads Platform API: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Apple-Ads-Platform-API",
  "identifier" : "/documentation/Apple-Ads-Platform-API/Get-Location-Group-by-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:location-groups-{}"
  },
  "title" : "Get Location Group"
}
-->

# Get Location Group

Retrieve a single location group by its unique identifier.

## Discussion

This endpoint returns the full state of a location group, including its membership definition, current `systemStatus`, `groupTotal`, and `eligibility`. To confirm a group was created correctly, or to inspect its current membership before attaching it to an ad group’s targeting configuration, use this endpoint.

The response’s `systemStatus` field can take any of the following values:

|Status   |Meaning                                                                                                                  |
|---------|-------------------------------------------------------------------------------------------------------------------------|
|`VALID`  |The group is fully evaluated and eligible for use in targeting. `groupTotal` reflects the current matched-location count.|
|`PENDING`|The system is evaluating the group’s dynamic rules. `groupTotal` may be `0`. Check again after a short interval.         |
|`INVALID`|One or more issues prevent the group from serving. Inspect `eligibility` for details.                                    |
|`DELETED`|The group has been soft-deleted and is no longer available for targeting.                                                |

The `PENDING` status appears immediately after a `DYNAMIC` group is created or after its `rules` are updated. The `STATIC` groups transition directly to `VALID` because membership is explicit and requires no evaluation.

Fetching a group by ID differs from a bulk query in a couple of ways:

|Constraint       |Detail                                                                                                                                                                      |
|-----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|Single group only|Retrieves one group by ID. Use <doc://com.apple.apple-ads-platform-api/documentation/Apple-Ads-Platform-API/Query-Location-Groups> to retrieve multiple groups with filters.|
|Deleted groups   |Soft-deleted groups are still retrievable by ID. They appear in the response with `systemStatus: DELETED`.                                                                  |

## Payload Examples

**Get Location Group:**

### Request

Retrieves a single location group by its unique identifier.

```
GET https://api.ads.apple.com/v1/location-groups/5764607523034238976
```

### Response

```json
{
 "result": {
   "id": "5764607523034238976",
   "name": "AwayFinder West Coast Stores",
   "brandId": "9151314442816847872",
   "adAccountId": "293897290",
   "groupType": "DYNAMIC",
   "systemStatus": "VALID",
   "rules": [
     {
       "field": "adminArea",
       "operator": "IN",
       "value": [
         "California",
         "Oregon",
         "Washington"
       ]
     }
   ],
   "groupTotal": 42,
   "isAllLocationsGroup": false,
   "description": "All AwayFinder locations on the West Coast",
   "creationTime": "2026-02-01T09:00:00Z",
   "modificationTime": "2026-03-25T16:00:00Z",
   "eligibility": {
     "status": "ELIGIBLE"
   }
 }
}
```

---

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)