Validation rules for caller ID feature blocking, phone number verification, and ownership verification processes

Caller ID Feature

CallerIdIsBlocked

Definition	Severity	API	Sample	Mode
Validate that the caller ID feature has been enabled for the organization's brand

Example Validation Report

{
  "code": "VALIDATION__CallerIdIsBlocked",
  "severity": "VIOLATION",
  "message": "Caller ID feature is blocked for the brand as per Apple Business policy"
}

Phone Number Verification

PhoneNumberOwnershipNotIndependentlyVerifiable

Definition	Severity	API	Sample	Mode
Validate that brand's ownership of the phoneNumber is independently verifiable

Example Validation Report

{
  "code": "VALIDATION__PhoneNumberOwnershipNotIndependentlyVerifiable",
  "severity": "VIOLATION",
  "message": "Brand ownership of 'phoneNumber' '{{value}}' could not be independently verified",
  "context": {
    "value": "+18006666666"
  },
  "details": {
    "createdDate": "2026-05-10T11:36:02.00Z",
    "submitted": [
      {
        "field": "$.callerIdDetails.phoneNumber",
        "value": "+18006666666"
      }
    ],
    "compared": [],
    "expected": []
  }
}

PhoneNumberVerificationRequired

Definition	Severity	API	Sample	Mode
Validate that phone number verification is completed

Example Validation Report

{
  "code": "VALIDATION__PhoneNumberVerificationRequired",
  "severity": "VIOLATION",
  "message": "Organization must complete phone verification for caller ID `{{id}}`",
  "context": {
    "id": "9467895078742654372"
  }
}

PhoneNumberVerificationUnsuccessful

Definition	Severity	API	Sample	Mode
Validate that an organization's attempt to verify a phone number was successful

Example Validation Report

{
  "code": "VALIDATION__PhoneNumberVerificationUnsuccessful",
  "severity": "VIOLATION",
  "message": "Phone verification for caller ID `{{id}}` was not successful",
  "context": {
    "id": "9467895078742654372"
  }
}

CallerIdPhoneNumberDoesNotMatchNumberUsedToVerify

Definition	Severity	API	Sample	Mode
Validate that the phone number being verified matches the caller ID phone number

Example Validation Report

{
  "code": "VALIDATION__CallerIdPhoneNumberDoesNotMatchNumberUsedToVerify",
  "severity": "VIOLATION",
  "message": "Phone number in caller ID `{{id}}` does not match number used to verify",
  "context": {
    "id": "9467895078742654372"
  }
}