<!--
{
  "availability" : [
    "iOS: 27.2.0 -",
    "iPadOS: 27.2.0 -",
    "macCatalyst: 27.2.0 -",
    "visionOS: 27.2.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "HomeKit",
  "identifier" : "/documentation/HomeKit/HMHome/ProvisionalHomeTransferError",
  "metadataVersion" : "0.1.0",
  "role" : "Enumeration",
  "symbol" : {
    "kind" : "Enumeration",
    "modules" : [
      "HomeKit"
    ],
    "preciseIdentifier" : "s:So6HMHomeC7HomeKitE011ProvisionalB13TransferErrorO"
  },
  "title" : "HMHome.ProvisionalHomeTransferError"
}
-->

# HMHome.ProvisionalHomeTransferError

Errors that occur when transferring a temporary home to a person’s home hub.

```
enum ProvisionalHomeTransferError
```

## Overview

This error type indicates that HomeKit was unable to attempt or complete a transfer, and HomeKit didn’t transfer any accessories to the home hub. To view information about partially successful transfers and error information for an individual accessory, use [`HMHome.ProvisionalHomeTransferResult`](/documentation/HomeKit/HMHome/ProvisionalHomeTransferResult).

## Topics

### Detecting transfer errors

[`case authenticationFailed`](/documentation/HomeKit/HMHome/ProvisionalHomeTransferError/authenticationFailed)

Authentication with the home hub failed.

[`case connectionFailed`](/documentation/HomeKit/HMHome/ProvisionalHomeTransferError/connectionFailed)

Establishing a network connection to the home hub failed.

[`case serverError`](/documentation/HomeKit/HMHome/ProvisionalHomeTransferError/serverError)

An unexpected server-side error or internal error occurred.

[`case targetHomeRejected`](/documentation/HomeKit/HMHome/ProvisionalHomeTransferError/targetHomeRejected)

The home hub rejected the target home identifier.

## Relationships

### Conforms To

[`SendableMetatype`](/documentation/Swift/SendableMetatype)

[`Hashable`](/documentation/Swift/Hashable)

[`Decodable`](/documentation/Swift/Decodable)

[`Encodable`](/documentation/Swift/Encodable)

[`Equatable`](/documentation/Swift/Equatable)

[`Sendable`](/documentation/Swift/Sendable)

[`Error`](/documentation/Swift/Error)

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)