<!--
{
  "availability" : [
    "Apple Ads Platform API: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Apple-Ads-Platform-API",
  "identifier" : "/documentation/Apple-Ads-Platform-API/Delete-Location-Group",
  "metadataVersion" : "0.1.0",
  "role" : "Web Service Endpoint",
  "symbol" : {
    "kind" : "Web Service Endpoint",
    "modules" : [
      "Apple Ads Platform API"
    ],
    "preciseIdentifier" : "rest:apple-ads-platform-api:delete:location-groups-{}"
  },
  "title" : "Delete Location Group"
}
-->

# Delete Location Group

Delete a location group by its unique identifier.

## Discussion

This endpoint soft-deletes the location group. The system doesn’t physically remove the record. Instead, it marks the record with `systemStatus: DELETED` and excludes it from query results and ad group targeting lookups. Deletion is permanent. There is no restore operation.

### Downstream Effects

Ad groups that reference the deleted location group lose that targeting constraint immediately and will only continue to serve if they are targeting other location groups.

Deletion carries a few important caveats:

|Constraint       |Detail                                                                                                        |
|-----------------|--------------------------------------------------------------------------------------------------------------|
|Permanent        |Deleted groups cannot be restored. Create a new group to replace a deleted one.                               |
|Still retrievable|A deleted group can still be fetched by ID and appears in queries that include a `deleted EQUALS true` filter.|
|Targeting impact |Ad groups referencing a deleted group lose the location constraint immediately upon deletion.                 |

## Payload Examples

**Delete Location Group:**

### Request

Deletes a location group by its unique identifier.

```
DELETE 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": "DELETED",
   "isAllLocationsGroup": false,
   "creationTime": "2026-02-01T09:00:00Z",
   "modificationTime": "2026-04-15T10:00:00Z"
 }
}
```

---

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)