---
updatedAt: 2026-04-15T15:59:51.000Z
agentTools:
  projectIndex: https://developers.pandadoc.com/llms.txt
---

# How to Enable Identity Verification

Require recipients to verify their identity via passcode, SMS, KBA, or ID check before viewing or signing a document.

## Problem

You need to confirm a recipient's identity before they can view or sign a document -- for compliance, security, or audit requirements.

## Prerequisites

* Authenticated via [OAuth](https://developers.pandadoc.com/reference/authentication-process) or [API key](https://developers.pandadoc.com/reference/api-key-authentication-process)
* A template with at least one recipient role, or an existing document with recipients

## Solution

Add `verification_settings` to a recipient either at document creation ([Create Document](https://developers.pandadoc.com/reference/create-document-from-pandadoc-template)) or on an existing document ([Update Recipient](https://developers.pandadoc.com/reference/update-recipient)).

### Choose a verification method

#### Passcode

The recipient must enter a passcode you define. It must be 6-100 characters with at least one letter and one digit.

```json
"verification_settings": {
    "verification_place": "before_open",
    "passcode_verification": {
        "passcode": "SimpleCode1"
    }
}
```

#### SMS one-time password

A one-time code is sent to the recipient's phone. The number must be in international format (e.g., `+1555667890`).

```json
"verification_settings": {
    "verification_place": "before_open",
    "phone_verification": {
        "phone_number": "+48123456789"
    }
}
```

#### Knowledge-based authentication (KBA)

The recipient answers identity questions generated from public records.

```json
"verification_settings": {
    "verification_place": "before_open",
    "kba_verification": {
        "enabled": true
    }
}
```

#### ID check

The recipient verifies identity with a government-issued ID.

```json
"verification_settings": {
    "verification_place": "before_open",
    "id_verification": {
        "enabled": true
    }
}
```

### Choose when to verify

Set `verification_place` to control when the check occurs:

| Value         | When                                       | Available for  |
| :------------ | :----------------------------------------- | :------------- |
| `before_open` | Before the recipient can view the document | All recipients |
| `before_sign` | Before the recipient can sign              | Signers only   |

<Image align="center" width="300px" src="https://files.readme.io/fc51aa5-image.png" />

### Full example: create a document with passcode verification

```json
{
    "name": "One Signer with Recipient Verification",
    "template_uuid": "Pw3syYYAvTU2h3Tx6vqatG",
    "recipients": [
        {
            "role": "Client",
            "first_name": "Signer",
            "last_name": "One",
            "email": "signer.one@example.com",
            "verification_settings": {
                "verification_place": "before_open",
                "passcode_verification": {
                    "passcode": "SimpleCode1"
                }
            }
        }
    ]
}
```

Replace `template_uuid` and `role` with values from your workspace.

## Related

* [How to Set a Signing Order](https://developers.pandadoc.com/docs/set-signing-order)
* [How to Send a Document via API](https://developers.pandadoc.com/docs/send-document)
* [Create Document endpoint](https://developers.pandadoc.com/reference/create-document-from-pandadoc-template)
* [Update Recipient endpoint](https://developers.pandadoc.com/reference/update-recipient)