Query Rejection Reasons for Brands

Query paginated policy assignment rejection reason details.

URL

POST https://api.ads.apple.com/v1/rejection-reasons/business-brands/query

Header Parameters

Name	Type	Description
`X-Ap-Context` Required	string

Response Codes

Status	Reason	Type
200	OK Content-Type: application/json	`PolicyAssignmentQueryResponse`
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 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 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-shaped object composed of QueryFilter conditions and QuerySort directives (QuerySortOrder), controlled by 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.