App Eligibility Endpoints
Check whether apps qualify to run ads and look up rejection reasons for creatives.
Overview
Not every app is eligible for promotion. Apple evaluates each app against a set of policy and technical criteria before it can serve ads, at a per-placement, per-country level of granularity. Each EligibilityResponse row reports a state of ELIGIBLE or INELIGIBLE for a given adamId, supplyPlacement, supplySource, countryOrRegion, and deviceClass, along with the minAge rating required in that market. To retrieve human-readable descriptions of any policy violations returned during ad creative review of App Store ad creatives, use the rejection reasons endpoints on this page.
This eligibility check applies to App Store app promotion (promotedObjectType: APPSTORE_APP) only. Apple Maps brand promotion (promotedObjectType: BUSINESS_BRAND) doesn’t use a dedicated eligibility query. Instead, the eligibility field on the Brand, Location, BusinessCategory, and LocationGroup objects reports serving eligibility directly, described in Eligibility. Apple Maps ad creative rejection reasons are also queried separately, with Query Rejection Reasons for Brands.
Use Search Apps Endpoints to find an app’s adamId and full app details, including via Get App Details by Adam ID, to check its eligibility. Once an app is eligible, use Product Pages Endpoints to discover its product pages to reference in an ad creative.
Explore the Endpoints
The following endpoints let you check eligibility and retrieve rejection reasons:
Method | Path | Description |
|---|---|---|
|
| Find Apps Eligibilities queries eligibility status for an app across supply placements and countries or regions. |
|
| Find Rejection Reasons queries rejection reasons for ad creatives associated with an app. |
|
| Gets Rejection Reasons By Id retrieves a single rejection reason by ID. |
Interpret the Eligibility States
The following states apply to EligibilityResponse.state values returned by the POST /v1/eligibilities/apps/query (Check App Eligibility) endpoint:
State | Description |
|---|---|
| You can promote the app at this placement and country combination. |
| You can’t promote the app at this placement and country combination. |