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

# Brand

A brand eligible for promotion through Apple Maps ads.

## Declaration

```data
object Brand
```

## Properties

id: ID of the brand. Filterable with EQUALS, IN. name: Primary display name for the brand. countryOrRegion: 2-character ISO 3166-1 alpha-2 country or region code. categories: Modern category taxonomy identifiers. The first entry is the primary category. See BusinessCategory. eligibility: Ad serving eligibility for this brand. See Eligibility. Read-only. Filterable with EQUALS on eligibility.status. creationTime: ISO-8601 timestamp when the brand record was created. Read-only. modificationTime: ISO-8601 timestamp of the last modification. Read-only.

## Discussion

Discussion The Brand object represents a business entity registered in Apple Ads. Use the id field as the promotedObjectId when creating a BUSINESS_BRAND campaign. You can actively promote only brands with eligibility.status: ELIGIBLE. To understand the business type, use the categories field. The countryOrRegion field identifies the primary market for the brand. Use Query Brands to list brands accessible to your ad account, and Get Brand by ID to retrieve a specific brand by its identifier. Query endpoint requests support fields marked Filterable in the properties as filter criteria. See Calling the Apple Ads Platform API for details on constructing queries. Example {   "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" }

## See Also

- [BrandResponse](apple-ads-platform-api/brandresponse.md)
- [BrandQueryResponse](apple-ads-platform-api/brandqueryresponse.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)