---
title: Query Ad Creatives
framework: Apple Ads Platform API
role: symbol
role_heading: Web Service Endpoint
platforms: [apple ads platform api 1.0+]
path: apple-ads-platform-api/post-creatives-query
---

# Query Ad Creatives

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

## URL

POST https://api.ads.apple.com/v1/creatives/query

## Header Parameters

X-Ap-Context:

## Response Codes

200 OK: 400 Bad Request: 401 Unauthorized: 403 Forbidden: 404 Not Found: 429 Too Many Requests: 500 Internal Server Error:

## Discussion

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 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 for the full set of supported comparison operators. Filterable Fields  |  |  |  |   |  |  |  |   |  |  |  |   |  |  |  |   |  |  |  |   |  |  |  |   |  |  |  |  The request body is a QueryRequest composed of QueryFilter conditions and QuerySort directives (QuerySortOrder), controlled by QueryPagination. Payload Examples

## See Also

- [Create an Ad Creative](apple-ads-platform-api/post-creatives.md)
- [Get an Ad Creative](apple-ads-platform-api/get-creatives-_id_.md)
- [Update an Ad Creative](apple-ads-platform-api/put-creatives-_id_.md)
- [Delete an Ad Creative](apple-ads-platform-api/delete-creatives-_id_.md)