---
title: "userIdentity(forEmailAddress:)"
framework: cloudkit
role: symbol
role_heading: Instance Method
path: "cloudkit/ckcontainer/useridentity(foremailaddress:)"
---

# userIdentity(forEmailAddress:)

Fetches the user identity for the specified email address.

## Declaration

```swift
func userIdentity(forEmailAddress email: String) async throws -> CKUserIdentity?
```

## Parameters

- `email`: The user’s email address.

## Return Value

Return Value The user identity for the email address.

## Discussion

Discussion Use this method to retrieve the identity of a user who the current user knows. The user you’re searching for must meet the following criteria: The user has run the app. The user grants the userDiscoverability permission for the container. This method searches for the user asynchronously and with a low priority. If you want the task to execute the request with a higher priority, create an instance of CKDiscoverUserIdentitiesOperation and configure it to use the necessary priority.