<!--
{
  "availability" : [
    "Apple Ads Platform API: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Apple-Ads-Platform-API",
  "identifier" : "/documentation/Apple-Ads-Platform-API/CreativeEligibility",
  "metadataVersion" : "0.1.0",
  "role" : "Object",
  "symbol" : {
    "kind" : "Object",
    "modules" : [
      "Apple Ads Platform API"
    ],
    "preciseIdentifier" : "data:apple-ads-platform-api:CreativeEligibility"
  },
  "title" : "CreativeEligibility"
}
-->

# CreativeEligibility

Eligibility state for an ad creative across supply sources and placements.

```
object CreativeEligibility
```

## Discussion

The `CreativeEligibility` object describes whether an ad creative is eligible to serve on specific supply sources and placements. It includes both allowed and blocked groups, providing granular visibility into where the ad creative can and cannot serve. To diagnose partial delivery restrictions without needing to check individual ad-level status fields, use this object.

### Example

```json
{
  "status": "INELIGIBLE",
  "allowedGroups": [
    {
      "supplyPlacement": ["APPSTORE_SEARCH_TAB", "APPSTORE_TODAY_TAB"],
      "countryOrRegion": ["US", "GB"]
    }
  ],
  "blockedGroups": [
    {
      "supplyPlacement": ["APPSTORE_SEARCH_RESULTS"],
      "countryOrRegion": ["CN"],
      "reason": "APP_NOT_ELIGIBLE"
    }
  ]
}
```

## Topics

### Dictionaries

[`object CreativeEligibility.AllowedGroups`](/documentation/Apple-Ads-Platform-API/CreativeEligibility/AllowedGroups-data.dictionary)

The supply sources and placements where this ad creative is eligible to serve.

[`object CreativeEligibility.BlockedGroups`](/documentation/Apple-Ads-Platform-API/CreativeEligibility/BlockedGroups-data.dictionary)

The supply sources and placements where this ad creative is not eligible to serve.

---

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)