---
title: GeoEligibility
framework: Apple Ads Platform API
role: symbol
role_heading: Object
platforms: [apple ads platform api 1.0+]
path: apple-ads-platform-api/geoeligibility
---

# GeoEligibility

Eligibility restrictions for a geographic location, scoped to the supply source specified in the request.

## Declaration

```data
object GeoEligibility
```

## Properties

blockedGroups: Array of GeoBlockedGroup objects. Each entry specifies the supply source and the reason the geo is blocked. Always non-empty when present. GeoEligibility is omitted from the response entirely when no restrictions apply. Read-only.

## Discussion

Discussion The SearchEntity responses embed GeoEligibility, which summarizes the serving eligibility for a geographic location relative to the supply source specified in the request. When present, blockedGroups is always non-empty. The API omits GeoEligibility entirely from the response when no restrictions apply. Each GeoBlockedGroup entry in blockedGroups identifies the supply source and the reason the geo is blocked. To pre-validate geo targeting choices before applying them to an ad group and avoid campaign configuration errors, use GeoEligibility data. Example {   "blockedGroups": [     {       "supplySource": [         "MAPS"       ],       "reasons": [         "COUNTRY_NOT_SUPPORTED"       ]     }   ] }

## See Also

- [GeoRequest](apple-ads-platform-api/georequest.md)
- [GeoSearchPostRequest](apple-ads-platform-api/geosearchpostrequest.md)
- [GeoSearchResponse](apple-ads-platform-api/geosearchresponse.md)
- [GeoSearchPagination](apple-ads-platform-api/geosearchpagination.md)
- [GeoBlockedGroup](apple-ads-platform-api/geoblockedgroup.md)
- [SearchEntity](apple-ads-platform-api/searchentity.md)