---
title: Query Brands
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-brands
---

# Query Brands

Retrieve a paginated list of brands using filters and sorting.

## URL

POST https://api.ads.apple.com/v1/business-brands/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 returns a paginated list of brands accessible to the ad account. An empty request body returns all brands with default pagination. The brand id returned in results corresponds to the promotedObjectId used when creating BUSINESS_BRAND campaigns. 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. Request Body See QueryRequest.  |  |  |   |  |  |   |  |  |   |  |  |  Payload Examples

## See Also

- [Get Brand by ID](apple-ads-platform-api/get-brand-by-id.md)
- [Query Business Categories](apple-ads-platform-api/query-categories.md)
- [Get Business Category](apple-ads-platform-api/get-category-by-id.md)
- [Query Rejection Reasons for Brands](apple-ads-platform-api/query-policy-assignments-(rejection-reasons)-for-external-consumers.md)