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

# Query Brands

Retrieve a paginated list of brands using filters and sorting.

## 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`](/documentation/Apple-Ads-Platform-API/QueryFilterOperator) for the full set of supported comparison operators.

### Filterable Fields

|Field               |Type         |Operators     |Sortable|Description                                                                                                                         |
|--------------------|:-----------:|:------------:|:------:|------------------------------------------------------------------------------------------------------------------------------------|
|`id`                |string       |`EQUALS`, `IN`|        |ID of the brand.                                                                                                                    |
|`eligibility.status`|string (enum)|`EQUALS`      |        |Ad serving eligibility for the brand. See <doc://com.apple.apple-ads-platform-api/documentation/Apple-Ads-Platform-API/Eligibility>.|

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).

## Request Body

See [`QueryRequest`](/documentation/Apple-Ads-Platform-API/QueryRequest).

|Field       |Type  |Required|Description                                     |
|------------|------|--------|------------------------------------------------|
|`filters`   |array |No      |Filter conditions to narrow results.            |
|`sorting`   |array |No      |Sort order for results (field + ASC/DESC).      |
|`pagination`|object|No      |Offset and page size. Defaults apply if omitted.|

## Payload Examples

**Query Brands:**

### Request

```json
POST /v1/business-brands/query

{
 "filters": [
   {
     "field": "id",
     "operator": "EQUALS",
     "value": "9151314442816847872"
   }
 ],
 "pagination": {
   "offset": 0,
   "pageSize": 20,
   "fetchTotalCount": true
 }
}
```

### Response

```json
{
 "result": [
   {
     "id": "9151314442816847872",
     "name": "AwayFinder",
     "countryOrRegion": "US",
     "categories": [
       "dining.restaurant"
     ],
     "eligibility": {
       "status": "ELIGIBLE"
     }
   }
 ],
 "pagination": {
   "totalCount": 1,
   "offset": 0,
   "pageSize": 20
 }
}
```

**Filter by Eligibility:**

### Request

Returns only brands you can use in a campaign. Confirm a brand’s eligibility with this filter before creating a Brands campaign, as described in [Ads on Apple Maps Endpoints](/documentation/Apple-Ads-Platform-API/brands-endpoints).

```json
POST /v1/business-brands/query

{
 "filters": [
   {
     "field": "eligibility.status",
     "operator": "EQUALS",
     "value": "ELIGIBLE"
   }
 ]
}
```

### Response

```json
{
 "result": [
   {
     "id": "9151314442816847872",
     "name": "AwayFinder",
     "countryOrRegion": "US",
     "categories": [
       "dining.restaurant"
     ],
     "eligibility": {
       "status": "ELIGIBLE"
     }
   }
 ],
 "pagination": {
   "totalCount": 1,
   "offset": 0,
   "pageSize": 20
 }
}
```

---

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)