<!--
{
  "availability" : [
    "iOS: 26.2.0 -",
    "iPadOS: 26.2.0 -",
    "macCatalyst: 26.2.0 -",
    "macOS: 26.2.0 -",
    "tvOS: 26.2.0 -",
    "visionOS: 26.2.0 -",
    "watchOS: 26.2.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Matter",
  "identifier" : "/documentation/Matter/MTRCommissioningDelegate/commissioning(_:needsThreadCredentialsWithScanResults:error:completion:)",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Method",
  "symbol" : {
    "kind" : "Instance Method",
    "modules" : [
      "Matter"
    ],
    "preciseIdentifier" : "c:objc(pl)MTRCommissioningDelegate(im)commissioning:needsThreadCredentialsWithScanResults:error:completion:"
  },
  "title" : "commissioning(_:needsThreadCredentialsWithScanResults:error:completion:)"
}
-->

# commissioning(_:needsThreadCredentialsWithScanResults:error:completion:)

Callback that gets called for a commissionee that supports Thread if Thread
network commissioning is required and an operational dataset was not provided
in MTRCommissioningParameters.

```
optional func commissioning(_ commissioning: MTRCommissioningOperation, needsThreadCredentialsWithScanResults networks: [MTRNetworkCommissioningClusterThreadInterfaceScanResultStruct]?, error: (any Error)?, completion: @escaping @Sendable (Data) -> Void)
```

```
optional func commissioning(_ commissioning: MTRCommissioningOperation, needsThreadCredentialsWithScanResults networks: [MTRNetworkCommissioningClusterThreadInterfaceScanResultStruct]?, error: (any Error)?) async -> Data
```

## Discussion

Commissioning will pause, including in cases when the network scan failed,
until the completion is invoked with the operational dataset the commissionee
should use, or until commissioning is stopped.

- error will be non-nil if a scan was attempted and failed.
- networks will be non-nil if a scan was attempted and succeeded.
- Both error and networks will be nil if no scan was performed.

---

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)