---
title: "requestDocument(_:completion:)"
framework: passkit
role: symbol
role_heading: Instance Method
path: "passkit/pkidentityauthorizationcontroller/requestdocument(_:completion:)"
---

# requestDocument(_:completion:)

Prompts the user to approve the request to get the identity information.

## Declaration

```swift
func requestDocument(_ request: PKIdentityRequest, completion: @escaping @Sendable (PKIdentityDocument?, (any Error)?) -> Void)
```

```swift
func requestDocument(_ request: PKIdentityRequest) async throws -> PKIdentityDocument
```

## Parameters

- `request`: The object that contains the identity elements the app requests.
- `completion`: The callback the system invokes after retrieving the document, or an error if one occurs.

## Discussion

Discussion The user needs to approve the request before releasing any data. When the user approves the request, the system returns the document. If the user doesn’t approve the request, the handler returns a PKIdentityError.Code.cancelled error. Only one request can be in progress at a time; otherwise, the method returns a PKIdentityError.Code.requestAlreadyInProgress error. Your app’s Info.plist file needs to provide a message for the NSIdentityUsageDescription key. If this key is missing, any attempt to request a document fails.

## See Also

### Requesting a document

- [checkCanRequestDocument(_:completion:)](passkit/pkidentityauthorizationcontroller/checkcanrequestdocument(_:completion:).md)