<!--
{
  "availability" : [
    "Apple Ads Platform API: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Apple-Ads-Platform-API",
  "identifier" : "/documentation/Apple-Ads-Platform-API/POST-creatives-query",
  "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:creatives-query"
  },
  "title" : "Query Ad Creatives"
}
-->

# Query Ad Creatives

Retrieve ad creatives that match structured filter, sort, and pagination criteria.

## Discussion

This endpoint queries ad creatives using the standard `QueryRequest` structure. The endpoint supports field filtering, multi-field sorting, and offset-based pagination. The system automatically scopes results to the ad accounts accessible to the authenticated caller. You can’t query by `adAccountId`. See [Creatives Endpoints](/documentation/Apple-Ads-Platform-API/creatives-endpoints) for the fields you can filter on.

By default, results exclude deleted ad creatives. To include deleted records, add an explicit filter on `"field": "deleted", "operator": "EQUALS", "value": true`.

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

### Filterable Fields

|Field         |Type         |Operators              |Sortable     |Description                                                                                                         |
|--------------|:-----------:|:---------------------:|:-----------:|--------------------------------------------------------------------------------------------------------------------|
|`id`          |integer      |`EQUALS`, `IN`         |Yes (default)|Primary identifier of the ad creative.                                                                              |
|`adAccountId` |integer      |`EQUALS`               |             |Reference to the ad account.                                                                                        |
|`name`        |string       |`EQUALS`, `STARTS_WITH`|             |Name of the ad creative.                                                                                            |
|`creativeType`|string (enum)|`EQUALS`, `IN`         |             |Type of ad creative. See <doc://com.apple.apple-ads-platform-api/documentation/Apple-Ads-Platform-API/CreativeType>.|
|`systemStatus`|string (enum)|`EQUALS`, `IN`         |             |System validation status.                                                                                           |
|`deleted`     |boolean      |`EQUALS`               |             |Whether the ad creative has been deleted. Excluded by default unless explicitly filtered to `true`.                 |

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 by Creative Type:**

### Request

```json
{
 "filters": [
   {
     "field": "creativeType",
     "operator": "EQUALS",
     "value": "CUSTOM_PRODUCT_PAGE"
   }
 ],
 "pagination": {
   "offset": 0,
   "pageSize": 20
 }
}
```

### Response

```json
{
 "result": [
   {
     "id": 666777888,
     "adAccountId": 123456789,
     "name": "AwayFinder - Summer Campaign Creative",
     "creativeType": "CUSTOM_PRODUCT_PAGE",
     "systemStatus": "VALID",
     "deleted": false,
     "creationTime": "2025-06-01T10:00:00.000",
     "modificationTime": "2025-06-01T10:00:00.000"
   }
 ]
}
```

**Query Invalid Creatives:**

### Request

```json
{
 "filters": [
   {
     "field": "systemStatus",
     "operator": "EQUALS",
     "value": "INVALID"
   }
 ]
}
```

### Response

```json
{
 "result": [
   {
     "id": 666777890,
     "adAccountId": 123456789,
     "name": "AwayFinder - Rejected Banner Creative",
     "creativeType": "LOCAL_ADS_SEARCH_CREATIVE",
     "systemStatus": "INVALID",
     "systemStatusReasons": [
       "POLICY_PROHIBITED"
     ],
     "deleted": false,
     "creationTime": "2025-05-15T08:00:00.000",
     "modificationTime": "2025-05-16T14:22:00.000"
   }
 ]
}
```

---

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)