> For the complete documentation index, see [llms.txt](https://docs.voveid.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.voveid.com/docs/dashboard/address-proof-setup.md).

# Set up address proof

Add an Address Proof step to a KYC flow, choose accepted documents, and configure their validation periods in the dashboard.

Add an **Address Proof** step to a KYC verification flow to collect a document showing the applicant's address. You choose which document types the flow accepts and configure a validation period for each type.

## Before you start

* Sign in to the dashboard for the environment you want to configure: [Sandbox](https://dashboard.voveid.net) or [Production](https://dashboard.voveid.com).
* Make sure your organization has Identity Verification enabled and your role allows you to create flows. If **Flows** or **Create Flow** is unavailable, ask your organization admin to check your [access](https://docs.voveid.com/docs/dashboard/team-roles-and-permissions.md).
* Decide which address documents and validation periods your organization wants to accept.

## 1. Open the flow builder

1. Under **Identity Verification**, select **Flows**.
2. Select **Create Flow**.
3. Enter a descriptive **Flow Name**, such as `Address proof example`.

You can combine address proof with other verification steps. Keep or configure **Liveness Verification** and any identity-document steps according to the journey you want applicants to complete.

## 2. Add an Address Proof step

1. In **Verification Steps**, select **Add Step**. An empty flow also offers **Add Your First Step**.
2. Set **Step Type** to **Address Proof**.
3. Enter a **Step Name**, or keep `address proof`.
4. Expand **Document Types** and select the types you want to accept. Select at least one type to enable **Add Step**.

Document types are grouped under **Financial**, **Utilities**, **Government**, **Housing**, **Employment**, and **Other**. For example, you can select **Bank Statement** and **Utility Bill Electricity**.

<figure><img src="https://4173094968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F83UoxmShmjD5iX8BJPn0%2Fuploads%2Fgit-blob-c825d8bc604f0cd469bac79926d94e2bf9e98cd7%2Faddress-proof-document-types.jpg?alt=media" alt="Add Verification Step dialog with Address Proof selected and financial and utility document choices"><figcaption><p>Choose the address document types your flow accepts.</p></figcaption></figure>

## 3. Set validation periods

Each selected type appears under **Validation Periods** with its own value in months. Review the initial values and change them to match your requirements. The dashboard provides a range of **1–12 months**.

For example, the configuration below accepts bank statements and electricity bills with a validation period of **3 months** each. This is an example configuration; choose values appropriate to your own requirements.

Collapse **Document Types** if you need more room to see the validation settings. Remove a selected type with the **×** next to its name, or use **Clear all** to start the selection again.

<figure><img src="https://4173094968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F83UoxmShmjD5iX8BJPn0%2Fuploads%2Fgit-blob-d23bd674670031a3f580f18e0ede00eea8b440c5%2Faddress-proof-validation-periods.jpg?alt=media" alt="Bank Statement and Utility Bill Electricity selected with validation periods of three months each and the Add Step button"><figcaption><p>Review the validation period for every selected document type, then select Add Step.</p></figcaption></figure>

Select **Add Step** to add the configuration to the flow builder. This closes the dialog; you still need to save the flow.

## 4. Review and save the flow

1. Confirm the **Address Proof** step appears under **Verification Steps**.
2. Select **Edit** on the step if you need to change its name, document selection, or validation periods.
3. Drag steps to arrange the journey. When enabled, liveness remains the first step.
4. Select **Save Changes**.
5. In **Verification Flows**, find the saved flow and confirm **Active** is on before using it for new sessions.

<figure><img src="https://4173094968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F83UoxmShmjD5iX8BJPn0%2Fuploads%2Fgit-blob-0fa46198b1c0d82c6f8992ae07d9997c4fc1e487%2Faddress-proof-flow-setup.jpg?alt=media" alt="Example KYC flow containing Liveness Verification followed by Address Proof, with Edit and Save Changes controls"><figcaption><p>Review the steps and save the flow. Adding a step alone does not save the flow.</p></figcaption></figure>

## 5. Use the flow for new verifications

Copy the saved flow's ID from **Verification Flows** and pass it as `flowId` when your backend [creates a verification session](https://docs.voveid.com/docs/kyc-api/verification-session.md). Keep the dashboard, API credentials, flow ID, and SDK environment in the same environment.

If you omit `flowId`, the organization's default flow is used. Creating an address-proof flow does not automatically make it the default.

For an existing flow, saving changes can create a new version with a different ID. Use the ID of the saved version for new sessions. See [Custom KYC flows](https://docs.voveid.com/docs/kyc-api/flows.md) for flow versioning and defaults.

## Troubleshooting

| What you see                                       | What to check                                                                                                                                                                           |
| -------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Add Step** is disabled                           | Select at least one address-proof document type.                                                                                                                                        |
| **Save Changes** is disabled                       | Enter a flow name and add a verification step.                                                                                                                                          |
| The applicant does not see an address-proof step   | Check that the session uses the saved flow's ID, that the flow contains Address Proof, and that all resources belong to the same environment. Without `flowId`, check the default flow. |
| Your changes are missing after leaving the builder | Select **Add Step** in the dialog, then **Save Changes** in the builder.                                                                                                                |
