<!--
{
  "availability" : [
    "Apple Ads Platform API: 1.0.0 -"
  ],
  "documentType" : "article",
  "framework" : "Apple-Ads-Platform-API",
  "identifier" : "/documentation/Apple-Ads-Platform-API/app-eligibility-endpoints",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "App Eligibility Endpoints"
}
-->

# 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`](/documentation/Apple-Ads-Platform-API/Brand), [`Location`](/documentation/Apple-Ads-Platform-API/Location), [`BusinessCategory`](/documentation/Apple-Ads-Platform-API/BusinessCategory), and [`LocationGroup`](/documentation/Apple-Ads-Platform-API/LocationGroup) objects reports serving eligibility directly, described in [`Eligibility`](/documentation/Apple-Ads-Platform-API/Eligibility). Apple Maps ad creative rejection reasons are also queried separately, with [`Query Rejection Reasons for Brands`](/documentation/Apple-Ads-Platform-API/Query-policy-assignments-(rejection-reasons)-for-external-consumers).

Use [Search Apps Endpoints](/documentation/Apple-Ads-Platform-API/search-apps-endpoints) to find an app’s `adamId` and full app details, including via [`Get App Details by Adam ID`](/documentation/Apple-Ads-Platform-API/Get-App-Details-by-Adam-ID), to check its eligibility. Once an app is eligible, use [Product Pages Endpoints](/documentation/Apple-Ads-Platform-API/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                                                                                                                                                                                   |
|------|------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|`POST`|`/v1/eligibilities/apps/query`                  |<doc://com.apple.apple-ads-platform-api/documentation/Apple-Ads-Platform-API/Find-Apps-eligibilities> queries eligibility status for an app across supply placements and countries or regions.|
|`POST`|`/v1/rejection-reasons/apps/query`              |<doc://com.apple.apple-ads-platform-api/documentation/Apple-Ads-Platform-API/Find-rejection-reasons> queries rejection reasons for ad creatives associated with an app.                       |
|`GET` |`/v1/rejection-reasons/apps/{rejectionReasonId}`|<doc://com.apple.apple-ads-platform-api/documentation/Apple-Ads-Platform-API/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`](/documentation/Apple-Ads-Platform-API/Find-Apps-eligibilities)) endpoint:

|State       |Description                                                         |
|------------|--------------------------------------------------------------------|
|`ELIGIBLE`  |You can promote the app at this placement and country combination.  |
|`INELIGIBLE`|You can’t promote the app at this placement and country combination.|

## Topics

[`Check App Eligibility`](/documentation/Apple-Ads-Platform-API/Find-Apps-eligibilities)

[`Query Rejection Reasons`](/documentation/Apple-Ads-Platform-API/Find-rejection-reasons)

[`Get Rejection Reasons`](/documentation/Apple-Ads-Platform-API/Gets-rejection-reasons-by-id)

## See Also

[Search Apps Endpoints](/documentation/Apple-Ads-Platform-API/search-apps-endpoints)

Browse the endpoints for searching apps and retrieving app details.

[Product Pages Endpoints](/documentation/Apple-Ads-Platform-API/product-pages-endpoints)

Retrieve product pages and their localized details.


---

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)