<!--
{
  "availability" : [
    "Apple Ads Platform API: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Apple-Ads-Platform-API",
  "identifier" : "/documentation/Apple-Ads-Platform-API/Query-policy-assignments-(rejection-reasons)-for-external-consumers",
  "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-business-brands-query"
  },
  "title" : "Query Rejection Reasons for Brands"
}
-->

# Query Rejection Reasons for Brands

Query paginated policy assignment rejection reason details.

## Discussion

This endpoint returns rejection reason details for policy assignments associated with brands. Use it to identify why a creative, asset, or brand entity was rejected so you can take corrective action.

The endpoint returns results as `BrandRejectionReasonResponse` objects, each containing the policy assignment ID, the affected entity, the component that triggered the rejection, and a human-readable rejection code, title, and body.

The request supports standard `filters`, `sorting`, and `pagination` via `PolicyAssignmentQueryRequest`. Filter by `promotedObjectId` to scope results to a specific brand. The endpoint returns only non-deleted rejection reasons.

See [`QueryFilterOperator`](/documentation/Apple-Ads-Platform-API/QueryFilterOperator) for the full set of supported comparison operators.

### Filterable Fields

|Field             |Type  |Operators|Sortable|Description                                                                                   |
|------------------|:----:|:-------:|:------:|----------------------------------------------------------------------------------------------|
|`promotedObjectId`|string|`IN`     |        |Scope results to a specific brand. The only field supported by `PolicyAssignmentQueryRequest`.|

The request body is a [`QueryRequest`](/documentation/Apple-Ads-Platform-API/QueryRequest)-shaped object 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).

## Request Body

`PolicyAssignmentQueryRequest`

|Field       |Type  |Required|Description                                                                                                                                                                                                   |
|------------|------|--------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|`filters`   |array |No      |Array of filter conditions. Supported field: `promotedObjectId`.                                                                                                                                              |
|`sorting`   |array |No      |Array of sort directives. Each entry specifies a `field` and `order` (`ASC` or `DESC`).                                                                                                                       |
|`pagination`|object|No      |Pagination object with `pageSize` (default: 20), `offset` (default: 0), and optional `fetchTotalCount` (boolean). When `fetchTotalCount` is `true`, the response includes the total count of matching records.|

## Payload Examples

**Query Rejection Reasons:**

### Request

Query rejection reasons for a specific brand, sorted by ID descending.

```json
{
 "filters": [
   {
     "field": "promotedObjectId",
     "operator": "IN",
     "value": [
       "1001",
       "1002"
     ]
   }
 ],
 "sorting": [
   {
     "field": "id",
     "order": "DESC"
   }
 ],
 "pagination": {
   "pageSize": 20,
   "offset": 0,
   "fetchTotalCount": true
 }
}
```

### Response

```json
{
 "result": [
   {
     "id": 76191,
     "promotedObjectId": "9223372036280979184",
     "promotedObjectType": "BUSINESS_BRAND",
     "entityId": "1582231810777739300",
     "entityType": "BUSINESS_BRAND",
     "componentType": "ENTITY_ASSET",
     "component": "3135832a-0645-5b84-a030-36394cbdbcf6",
     "code": "PERSONAL_INFORMATION",
     "title": "Personal Information",
     "body": "Content containing personally identifiable information is not allowed."
   }
 ],
 "pagination": {
   "totalCount": 1,
   "offset": 0,
   "pageSize": 20
 }
}
```

---

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)