<!--
{
  "availability" : [
    "Apple Ads Platform API: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Apple-Ads-Platform-API",
  "identifier" : "/documentation/Apple-Ads-Platform-API/Find-rejection-reasons",
  "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:rejection-reasons-apps-query"
  },
  "title" : "Query Rejection Reasons"
}
-->

# Query Rejection Reasons

Query ad creative rejection reasons for apps and return why each ad creative failed approval.

## Discussion

This endpoint retrieves a list of ad creative rejection reasons based on filtering and pagination criteria. See [`CreativeRejectionReason`](/documentation/Apple-Ads-Platform-API/CreativeRejectionReason) for the full field reference, including `creativeId` and the `reasonLevel` values.

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` |        |The Adam ID of the app whose product page triggered the rejection|

Only `adamId` is confirmed filterable; other [`CreativeRejectionReason`](/documentation/Apple-Ads-Platform-API/CreativeRejectionReason) fields aren’t documented as query filters. The request body is a [`QueryRequest`](/documentation/Apple-Ads-Platform-API/QueryRequest) 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).

## Payload Examples

**Query Rejection Reasons:**

### Request

```json
POST /v1/rejection-reasons/apps/query

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

### Response

```json
{
 "result": [
   {
     "id": 112233445,
     "adamId": 123456789,
     "creativeId": 456789,
     "productPageId": "1a2b3c4d-0001",
     "assetId": null,
     "supplySource": "APPSTORE",
     "supplyPlacement": "APPSTORE_SEARCH_RESULTS",
     "countryOrRegion": "US",
     "languageCode": "en-US",
     "reasonType": "REJECTION_REASON",
     "reasonCode": "APP_NOT_ELIGIBLE",
     "comment": null,
     "reasonLevel": "CUSTOM_PRODUCT_PAGE_LOCALE",
     "creationTime": "2026-02-05T08:30:00.000",
     "modificationTime": "2026-03-05T08:30:00.000"
   }
 ],
 "pagination": {
   "totalCount": 1,
   "offset": 0,
   "pageSize": 20
 }
}
```

## See Also

[App Eligibility Endpoints](/documentation/Apple-Ads-Platform-API/app-eligibility-endpoints)

Check whether apps qualify to run ads and look up rejection reasons for creatives.


---

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)