<!--
{
  "availability" : [
    "Apple Ads Platform API: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Apple-Ads-Platform-API",
  "identifier" : "/documentation/Apple-Ads-Platform-API/Find-Apps-eligibilities",
  "metadataVersion" : "0.1.0",
  "role" : "Web Service Endpoint",
  "symbol" : {
    "kind" : "Web Service Endpoint",
    "modules" : [
      "Apple Ads Platform API"
    ],
    "preciseIdentifier" : "rest:apple-ads-platform-api:post:eligibilities-apps-query"
  },
  "title" : "Check App Eligibility"
}
-->

# Check App Eligibility

Check whether an app is eligible to run on certain Apple Ads placements and in specific countries or regions.

## Discussion

This endpoint checks whether an app is eligible to run Apple Ads campaigns in specified countries or regions. The response contains per-app eligibility status, along with the specific supply placements and markets where advertising is allowed or blocked.

To confirm that your app can be promoted in the target markets, use this endpoint before creating campaigns. Attempting to run campaigns in ineligible markets will result in zero delivery. Calling this endpoint early in the campaign setup workflow avoids wasted configuration.

Ineligibility reasons can include: the app is not available in that market, regional distribution restrictions set in App Store Connect, or Apple Ads policy violations.

See [`QueryFilterOperator`](/documentation/Apple-Ads-Platform-API/QueryFilterOperator) for the full set of supported comparison operators.

### Filterable Fields

|Field            |Type           |Operators     |Sortable|Description                                  |
|-----------------|:-------------:|:------------:|:------:|---------------------------------------------|
|`adamId`         |integer (int64)|`EQUALS`      |No      |The Adam ID of the app                       |
|`supplyPlacement`|string         |`EQUALS`, `IN`|Yes     |The supply placement being checked           |
|`state`          |string         |`EQUALS`, `IN`|Yes     |Eligibility state: `ELIGIBLE` or `INELIGIBLE`|
|`countryOrRegion`|string         |`EQUALS`, `IN`|Yes     |The country or region evaluated              |
|`deviceClass`    |string         |`EQUALS`, `IN`|Yes     |The device class evaluated                   |

See [`EligibilityQueryRequest`](/documentation/Apple-Ads-Platform-API/EligibilityQueryRequest) for the full field list. The request body is a [`QueryRequest`](/documentation/Apple-Ads-Platform-API/QueryRequest)-shaped object composed of [`QueryFilter`](/documentation/Apple-Ads-Platform-API/QueryFilter) conditions and [`QuerySort`](/documentation/Apple-Ads-Platform-API/QuerySort) directives ([`QuerySortOrder`](/documentation/Apple-Ads-Platform-API/QuerySortOrder)), controlled by [`QueryPagination`](/documentation/Apple-Ads-Platform-API/QueryPagination).

## Request Body

The `state` field resolves to one of the following values:

|Status      |Description                                                       |
|------------|------------------------------------------------------------------|
|`ELIGIBLE`  |The app is approved to run ads in the specified country or region.|
|`INELIGIBLE`|The app cannot run ads in the specified country or region.        |

### Response Structure

Each item in `result` is a flat `EligibilityResponse` row for a specific combination of app, supply placement, supply source, country, and device class.

|Field             |Type             |Description                                                             |
|------------------|-----------------|------------------------------------------------------------------------|
|`adamId`          |integer (int64)  |The Adam ID of the app                                                  |
|`supplyPlacement` |string           |The supply placement being checked                                      |
|`supplySource`    |string           |The supply source being checked                                         |
|`minAge`          |number           |The minimum age rating required to serve ads for this app in this market|
|`state`           |string           |Eligibility state: `ELIGIBLE` or `INELIGIBLE` (default `ELIGIBLE`)      |
|`countryOrRegion` |string           |The country or region evaluated                                         |
|`deviceClass`     |string           |The device class evaluated                                              |
|`creationTime`    |string (ISO 8601)|When this eligibility record was created                                |
|`modificationTime`|string (ISO 8601)|When this eligibility record was last modified                          |

An app that is eligible in some placements and ineligible in others appears as multiple rows, one per combination.

Keep the following constraints in mind when checking eligibility:

|Constraint               |Detail                                                                                        |
|-------------------------|----------------------------------------------------------------------------------------------|
|Pre-campaign check       |Always call this endpoint before creating campaigns in new markets.                           |
|Distribution restrictions|Ineligibility may reflect App Store Connect distribution settings, not just policy violations.|

## Payload Examples

**Check App Eligibility:**

### Request

```json
POST /v1/eligibilities/apps/query

{
 "filters": [
   {
     "field": "adamId",
     "operator": "EQUALS",
     "value": 123456789
   }
 ],
 "pagination": {
   "offset": 0,
   "pageSize": 20
 }
}
```

### Response

```json
{
 "result": [
   {
     "adamId": 123456789,
     "supplyPlacement": "APPSTORE_SEARCH_RESULTS",
     "supplySource": "APPSTORE",
     "minAge": 4,
     "state": "ELIGIBLE",
     "countryOrRegion": "US",
     "deviceClass": "IPHONE"
   },
   {
     "adamId": 123456789,
     "supplyPlacement": "APPSTORE_SEARCH_RESULTS",
     "supplySource": "APPSTORE",
     "minAge": 4,
     "state": "ELIGIBLE",
     "countryOrRegion": "GB",
     "deviceClass": "IPHONE"
   }
 ],
 "pagination": {
   "totalCount": 2,
   "offset": 0,
   "pageSize": 20
 }
}
```

---

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)