Query Rejection Reasons
Query ad creative rejection reasons for apps and return why each ad creative failed approval.
URL
POST https://api.ads.apple.com/v1/rejection-reasons/apps/queryHeader Parameters
| Name | Type | Description |
|---|---|---|
X-Ap-Context Required | string |
Response Codes
| Status | Reason | Type | Description |
|---|---|---|---|
| 200 | OK Content-Type: application/json | CreativeRejectionReasonQueryResponse | |
| 400 | Bad Request Content-Type: application/json | Error | |
| 401 | Unauthorized Content-Type: application/json | Error | |
| 403 | Forbidden Content-Type: application/json | Error | |
| 404 | Not Found Content-Type: application/json | Error | |
| 429 | Too Many Requests Content-Type: application/json | Error | |
| 500 | Internal Server Error Content-Type: application/json | Error |
Discussion
This endpoint retrieves a list of ad creative rejection reasons based on filtering and pagination criteria. See CreativeRejectionReason for the full field reference, including creativeId and the reasonLevel values.
See QueryFilterOperator for the full set of supported comparison operators.
Filterable Fields
Field | Type | Operators | Sortable | Description |
|---|---|---|---|---|
| integer (int64) |
| The Adam ID of the app whose product page triggered the rejection |
Only adamId is confirmed filterable; other CreativeRejectionReason fields aren’t documented as query filters. The request body is a QueryRequest composed of QueryFilter conditions and QuerySort directives (QuerySortOrder), controlled by QueryPagination.