Location brand validation rules for brand ID resolution and country code matching

Brand ID

Precondition applicable to all listed validations
brandId is present

BrandReferencedByLocationRequiresReview

Definition	Severity	API	Sample	Mode
Validate that the referenced brand is expected to be associated with a location

Example Validation Report

{
  "code": "VALIDATION__BrandReferencedByLocationRequiresReview",
  "severity": "WARNING",
  "message": "Brand ID '{{brandId}}' referenced by location requires review",
  "context": {
    "brandId": "9467895078742656755"
  },
  "details": {
    "createdDate": "2026-03-03T13:58:43.946Z",
    "submitted": [],
    "compared": [],
    "expected": []
  }
}

BrandNotAllowedToHaveLocation

Definition	Severity	API	Sample	Mode
Validate that Apple Maps policies applicable to the brand permit association with a location

Example Validation Report

{
  "code": "VALIDATION__BrandNotAllowedToHaveLocation",
  "severity": "VIOLATION",
  "message": "Apple Maps policies applicable to this brand do not permit association with any location",
  "details": {
    "createdDate": "2026-03-03T13:58:43.946Z",
    "submitted": [],
    "compared": [],
    "expected": []
  }
}

CountOfBrandLocationsExceedsThresholdCheck

Preconditions
Organization (company) is VERIFIED
Brand's business review state is APPROVED

Definition	Severity	API	Sample	Mode
Validate that the count of locations associated with brandId does not exceed a threshold

Example Validation Report

{
  "code": "VALIDATION__CountOfBrandLocationsExceedsThresholdCheck",
  "severity": "INFO",
  "message": "Count of locations for brand exceeds threshold. Location is pending Apple Business operations review.",
  "details": {
    "createdDate": "2026-03-03T13:58:43.946Z",
    "submitted": [],
    "compared": [],
    "expected": []
  }
}

LocationMustHaveBrandId

Preconditions
orgId resolves to organization that is location owner

Definition	Severity	API	Sample	Mode
Validate that brandId is present

Example Validation Report

{
  "code": "VALIDATION__LocationMustHaveBrandId",
  "severity": "VIOLATION",
  "message": "'{{field}}' must be present",
  "context": {
    "field": "brandId"
  },
  "details": {
    "compared": [],
    "expected": [
      {
        "field": "$.locationDetails.brandId"
      }
    ],
    "submitted": [],
    "createdDate": "2026-03-03T13:58:43.946Z"
  }
}

Business ID

BusinessIdMustNotBePresent

Definition	Severity	API	Sample	Mode
Validate that businessId is not present

note

businessId is a legacy field name for what is now brandId. Submit brandId to associate a Location with a Brand.

Cross-feature

CountryCodeMustMatchBrandCountryCodes

Preconditions
structuredAddress is present

Definition	Severity	API	Sample	Mode
Validate that countryCode matches at least one (1) of the brand's listed countryCodes