---
title: BrandQueryResponse
framework: Apple Ads Platform API
role: symbol
role_heading: Object
platforms: [apple ads platform api 1.0+]
path: apple-ads-platform-api/brandqueryresponse
---

# BrandQueryResponse

The Query Brands endpoint returns this response object.

## Declaration

```data
object BrandQueryResponse
```

## Properties

result: Array of Brand objects matching the query. Empty array if no brands match. Read-only. pagination: Pagination metadata for the result set. See QueryPaginationResult. Read-only. error: Error details if the request failed. Absent on success. See Error. Read-only.

## Discussion

Discussion The Query Brands returns BrandQueryResponse as the top-level envelope. The result array contains all Brand objects that match the supplied filters, subject to pagination. To page through large result sets, use pagination.totalCount and pagination.offset. Example {   "result": [     {       "id": "123456789",       "name": "AwayFinder",       "countryOrRegion": "US",       "categories": [         "shopping.retail",         "dining.restaurant"       ],       "eligibility": {         "status": "ELIGIBLE",         "blockedGroups": [],         "allowedGroups": [],         "modificationTime": "2025-01-10T08:00:00.000"       },       "creationTime": "2025-01-10T08:00:00.000",       "modificationTime": "2025-01-10T08:00:00.000"     }   ],   "pagination": {     "offset": 0,     "pageSize": 20,     "totalCount": 1   } }

## See Also

- [Brand](apple-ads-platform-api/brand.md)
- [BrandResponse](apple-ads-platform-api/brandresponse.md)
- [BrandRejectionReasonResponse](apple-ads-platform-api/brandrejectionreasonresponse.md)
- [BusinessCategory](apple-ads-platform-api/businesscategory.md)
- [BusinessCategoryResponse](apple-ads-platform-api/businesscategoryresponse.md)
- [BusinessCategoryQueryResponse](apple-ads-platform-api/businesscategoryqueryresponse.md)
- [Location](apple-ads-platform-api/location.md)
- [LocationResponse](apple-ads-platform-api/locationresponse.md)
- [LocationGroup](apple-ads-platform-api/locationgroup.md)
- [LocationGroupCreate](apple-ads-platform-api/locationgroupcreate.md)
- [LocationGroupUpdate](apple-ads-platform-api/locationgroupupdate.md)
- [LocationGroupResponse](apple-ads-platform-api/locationgroupresponse.md)
- [LocationGroupQueryResponse](apple-ads-platform-api/locationgroupqueryresponse.md)
- [LocationQueryResponse](apple-ads-platform-api/locationqueryresponse.md)
- [Eligibility](apple-ads-platform-api/eligibility.md)