<!--
{
  "availability" : [
    "iOS: 10.0.0 -",
    "iPadOS: 10.0.0 -",
    "macCatalyst: 10.0.0 -",
    "visionOS: 1.0.0 -",
    "watchOS: 9.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "CallKit",
  "identifier" : "/documentation/CallKit/CXHandle",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "CallKit"
    ],
    "preciseIdentifier" : "c:objc(cs)CXHandle"
  },
  "title" : "CXHandle"
}
-->

# CXHandle

A way to reach a call recipient, such as a phone number or email address.

```
class CXHandle
```

## Overview

When the telephony provider receives an incoming call or the user starts an outgoing call, the other caller is identified by a [`CXHandle`](/documentation/CallKit/CXHandle) object. For a caller identified by a phone number, the handle type is [`CXHandle.HandleType.phoneNumber`](/documentation/CallKit/CXHandle/HandleType/phoneNumber) and the value is a sequence of digits. For a caller identified by an email address, the handle type is [`CXHandle.HandleType.emailAddress`](/documentation/CallKit/CXHandle/HandleType/emailAddress) and the value is an email address. For a caller identified in any other way, the handle type is [`CXHandle.HandleType.generic`](/documentation/CallKit/CXHandle/HandleType/generic) and the value typically follows some domain-specific format, such as a username, numeric ID, or URL.

## Topics

### Creating New Handles

[`init(type:value:)`](/documentation/CallKit/CXHandle/init(type:value:))

Initializes a new handle of a given type with the specified value.

### Accessing Handle Attributes

[`type`](/documentation/CallKit/CXHandle/type)

The type of the handle.

[`value`](/documentation/CallKit/CXHandle/value)

The value of the handle.

### Comparing Handles

[`isEqualToHandle:`](/documentation/CallKit/CXHandle/isEqualToHandle:)

Returns a Boolean value that indicates whether a given handle is equal to the receiver.

### Constants

[`CXHandle.HandleType`](/documentation/CallKit/CXHandle/HandleType)

The possible types of handles.


---

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)