--- title: Check App Eligibility framework: Apple Ads Platform API role: symbol role_heading: Web Service Endpoint platforms: [apple ads platform api 1.0+] path: apple-ads-platform-api/find-apps-eligibilities --- # Check App Eligibility Check whether an app is eligible to run on certain Apple Ads placements and in specific countries or regions. ## URL POST https://api.ads.apple.com/v1/eligibilities/apps/query ## Header Parameters X-Ap-Context: ## Response Codes 200 OK: 400 Bad Request: 401 Unauthorized: 403 Forbidden: 404 Not Found: 429 Too Many Requests: 500 Internal Server Error: ## Discussion 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 for the full set of supported comparison operators. Filterable Fields | | | | | | | | | | | | | | | | | | | | | | | | See EligibilityQueryRequest for the full field list. The request body is a QueryRequest-shaped object composed of QueryFilter conditions and QuerySort directives (QuerySortOrder), controlled by QueryPagination. Request Body The state field resolves to one of the following values: | | | 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. | | | | | | | | | | | | | | | | | | | | 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: | | | Payload Examples ## HTTP Body See EligibilityQueryRequest. ## See Also - [Query Rejection Reasons](apple-ads-platform-api/find-rejection-reasons.md) - [Get Rejection Reasons](apple-ads-platform-api/gets-rejection-reasons-by-id.md)