<!--
{
  "availability" : [
    "Search Ads: 5.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Apple_Ads",
  "identifier" : "/documentation/apple_ads/Find-App-Eligibility-Records",
  "metadataVersion" : "0.1.0",
  "role" : "Web Service Endpoint",
  "symbol" : {
    "kind" : "Web Service Endpoint",
    "modules" : [
      "Apple Ads"
    ],
    "preciseIdentifier" : "rest:apple_ads:post:v5-apps-{}-eligibilities-find"
  },
  "title" : "Find App Eligibility Records"
}
-->

# Find App Eligibility Records

Fetches app eligibility records by adam ID.

## Discussion

Use this endpoint to determine whether an app is eligible to promote in a campaign. Use a [`Selector`](/documentation/apple_ads/Selector) [`Condition`](/documentation/apple_ads/Condition) to search for a specific country or region, [`DeviceClass`](/documentation/apple_ads/DeviceClass), [`AgeCriteria`](/documentation/apple_ads/AgeCriteria), or [`SupplySource`](/documentation/apple_ads/SupplySource).  See the [`EligibilityRecord`](/documentation/apple_ads/EligibilityRecord) object for parameter descriptions and selector condition operators.

### Payload example: Find app eligibility records

**Request:**

```
POST https://api.searchads.apple.com/api/v5/apps/<adamId>/eligibilities/find

{
    "conditions": [
        {
            "field": "countryOrRegion",
            "operator": "IN",
            "values": ["US", "MX"]
        },
        {
            "field": "supplySource",
            "operator": "EQUALS",
            "values": ["APPSTORE_TODAY_TAB"]
        }
    ],
    "pagination": {
        "offset": 0,
        "limit": 2
    }
}
```

**Response:**

```json
{
    "data": [
        {
            "adamId": 123456789,
            "deviceClass": "IPHONE",
            "state": "ELIGIBLE",
            "minAge": 18,
            "countryOrRegion": "US",
            "supplySource": "APPSTORE_TODAY_TAB"
        },
        {
            "adamId": 123456789,
            "deviceClass": "IPAD",
            "state": "INELIGIBLE",
            "minAge": 18,
            "countryOrRegion": "US",
            "supplySource": "APPSTORE_TODAY_TAB"
        }
    ],
    "pagination": {
        "totalResults": 4,
        "startIndex": 0,
        "itemsPerPage": 2
    }
}
```

---

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)