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

# Query Assets

Retrieve a paginated list of creative assets using filters and sorting.

## URL

POST https://api.ads.apple.com/v1/assets/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 assets using a standard QueryRequest body. Filter by promotedObjectId to retrieve all assets for a specific brand. An empty request body returns all assets with default pagination. After uploading an asset, use this endpoint to check eligibility status in bulk rather than polling each asset individually. See QueryFilterOperator for the full set of supported comparison operators. Filterable Fields  |  |  |  |   |  |  |  |   |  |  |  |   |  |  |  |   |  |  |  |   |  |  |  |   |  |  |  |   |  |  |  |   |  |  |  |   |  |  |  |   |  |  |  |  providerAssetMetadata, assetDetails, eligibility, and eligibility.status aren’t filterable. The request body is a QueryRequest composed of QueryFilter conditions and QuerySort directives (QuerySortOrder), controlled by QueryPagination. Request Body See QueryRequest. Querying assets carries a couple of caveats around scope and variants:  |   |   |  Payload Examples

## See Also

- [Upload Asset](apple-ads-platform-api/upload-asset.md)
- [Get Asset](apple-ads-platform-api/get-asset-by-id.md)
- [Delete Asset](apple-ads-platform-api/delete-asset-by-id.md)