Type Claim Validation

Description

Notification about a location claim that is in review or awaiting review by Apple Business. CLAIM_VALIDATION notification type is generated when any of the following is true:

• Location is created by delegated partner on behalf of a location owner.
• Location owner claims a location at a time when it has already delegated a partner to manage all their brand's locations.
• Location is created by a partner on behalf of a location owner using a grant authorization (OAuth app).
• Location owner claims a location in Apple Business portal and subsequently delegates the location to a partner while the location is in review or awaiting review by Apple Business.

Response Body

Parent	Name	Output
$.	data[]
data[]	orgId
data[]	id
data[]	createdDate
data[]	feedbackUrl
data[]	resourceDetails
data[]	type
resourceDetails	etag
resourceDetails	resourceId
resourceDetails	resourceType
resourceDetails	state
resourceDetails	brandId

Example Response Body

Delegated partner successfully creates a location "triggering" a task for Apple Business to review a location claim. The following notification is generated.

Notification For	Process Initiated by
Delegated partner	Delegated partner

Delegated partner calls the notification API using their own orgId as the URI parameter, along with their own access token, to retrieve the notification

{
  "data": [
    {
      "orgId": "9467895078742654994",
      "id": "9467895078742654972",
      "createdDate": "2026-10-10T17:32:05.00Z",
      "type": "CLAIM_VALIDATION",
      "feedbackUrl": "/v1/orgs/9467895078742654994/feedback?ql=id==9467895078742654309",
      "resourceDetails": {
        "resourceType": "LOCATION",
        "resourceId": "9467895078742654964",
        "etag": "d53c97a0-7fff-11ee-b962-0242ac120002",
        "state": "PROCESSING",
        "brandId": "9467895078742654946"
      }
    }
  ],
  "pagination": {
    "cursors": {
      "after": "8U54a61d9b495324"
    },
    "next": "/v1/orgs/9467895078742654994/notifications?ql=createdDate=ge=2026-10-01T00:00:00Z;createdDate=le=2026-10-11T00:00:00Z;resourceType==LOCATION&limit=1&after=8U54a61d9b495324"
  }
}