<!--
{
  "availability" : [
    "iOS: 10.0.0 -",
    "iPadOS: 10.0.0 -",
    "macCatalyst: 13.1.0 -",
    "macOS: 10.12.0 -",
    "tvOS: 10.0.0 -",
    "visionOS: 1.0.0 -",
    "watchOS: 3.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "CloudKit",
  "identifier" : "/documentation/CloudKit/CKUserIdentity/LookupInfo-swift.class",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "CloudKit"
    ],
    "preciseIdentifier" : "c:objc(cs)CKUserIdentityLookupInfo"
  },
  "title" : "CKUserIdentity.LookupInfo"
}
-->

# CKUserIdentity.LookupInfo

The criteria to use when searching for discoverable iCloud users.

```
class LookupInfo
```

## Overview

Use this object when you want to discover the identities of your app’s users with [`CKDiscoverUserIdentitiesOperation`](/documentation/CloudKit/CKDiscoverUserIdentitiesOperation), or to create a share’s participants with [`CKFetchShareParticipantsOperation`](/documentation/CloudKit/CKFetchShareParticipantsOperation).

You create individual instances by providing an email address, phone number, or user record ID. Alternatively, create an array of objects all at once by using one of the convenience methods, such as [`lookupInfos(withEmails:)`](/documentation/CloudKit/CKUserIdentity/LookupInfo-swift.class/lookupInfos(withEmails:)).

## Topics

### Creating a Lookup Info

[`init(emailAddress:)`](/documentation/CloudKit/CKUserIdentity/LookupInfo-swift.class/init(emailAddress:))

Creates a lookup info for the specified email address.

[`init(phoneNumber:)`](/documentation/CloudKit/CKUserIdentity/LookupInfo-swift.class/init(phoneNumber:))

Creates a lookup info for the specified phone number.

[`init(userRecordID:)`](/documentation/CloudKit/CKUserIdentity/LookupInfo-swift.class/init(userRecordID:))

Creates a lookup info for the specified user record ID.

### Creating Multiple Lookup Infos

[`lookupInfos(withEmails:)`](/documentation/CloudKit/CKUserIdentity/LookupInfo-swift.class/lookupInfos(withEmails:))

Returns an array of lookup infos for the specified email addresses.

[`lookupInfos(withPhoneNumbers:)`](/documentation/CloudKit/CKUserIdentity/LookupInfo-swift.class/lookupInfos(withPhoneNumbers:))

Returns an array of lookup infos for the specified phone numbers.

[`lookupInfos(with:)`](/documentation/CloudKit/CKUserIdentity/LookupInfo-swift.class/lookupInfos(with:))

Returns an array of lookup infos for the specified user record IDs.

### Accessing the Criteria

[`emailAddress`](/documentation/CloudKit/CKUserIdentity/LookupInfo-swift.class/emailAddress)

The user’s email address.

[`phoneNumber`](/documentation/CloudKit/CKUserIdentity/LookupInfo-swift.class/phoneNumber)

The user’s phone number.

[`userRecordID`](/documentation/CloudKit/CKUserIdentity/LookupInfo-swift.class/userRecordID)

The ID of the user record.


---

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)