> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.withpersona.com/2021-05-14/verification-lifecycle/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.withpersona.com/_mcp/server.

# Verification Lifecycle

> Understand the statuses a Verification moves through from creation to completion.

In the Persona data model, a verification is an independent object that is associated with a Persona organization.

A verification moves through various statuses as it progresses from initialization to data submission and finally to verification completion.

## Verification lifecycle

The basic lifecycle of a verification looks like this:

1. A new verification is initialized with the status `initiated`. It is configured from a VerificationTemplate object.
   * A VerificationTemplate describes the collection options and required verification checks for a verification. You will need to create this template first.
2. As the end user completes the verification, attributes and images are attached to the verification.
3. The verification is submitted with the status of `submitted`. Attributes and images can no longer be changed.
4. Persona processes the submitted data and generates check and decision statuses based on the configuration from the VerificationTemplate.
   * If verification passes, the verification status is updated to `passed`.
   * If verification fails, the verification status is updated to `failed`.
   * If verification skipped, the verification status is updated to `skipped`.

## Verification statuses

| Status           | Description                                                                                                                                                                                                                                                                                                                                                                                |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `initiated`      | Verification has started. Claimed information can now sent and saved to the server for verification.                                                                                                                                                                                                                                                                                       |
| `confirmed`      | Verification has been confirmed. This status is specific to PhoneNumber and Email verifications, where a confirmation code has been entered and verified.                                                                                                                                                                                                                                  |
| `submitted`      | Verification has been submitted. The claimed information is frozen and Persona will process the verification.                                                                                                                                                                                                                                                                              |
| `passed`         | Verification has passed. The required checks have passed and the information is verified.                                                                                                                                                                                                                                                                                                  |
| `failed`         | Verification has failed. Some or all of the required checks have failed and verification has failed.                                                                                                                                                                                                                                                                                       |
| `requires_retry` | Verification requires a resubmission. The checks could not be fully processed due to issues with the submitted information. *Note: This status is now deprecated. For use cases that may require retrying a verification, it is recommended to condition on the `passed` status, `failed` status, or if within an inquiry, the number of failed verification attempts within the inquiry.* |
| `canceled`       | Verification canceled before completing. This usually indicates an internal server error.                                                                                                                                                                                                                                                                                                  |
| `skipped`        | Verification skipped. Skipping is triggered when a check configured to skip on failure fails; for example, an AAMVA verification may be skipped when the submitted ID belongs to a jurisdiction Persona does not currently support.                                                                                                                                                        |

## Learn more

See our Help Center for more details about the verification lifecycle:

* [Results and statuses FAQ](https://help.withpersona.com/verifications/faq/results-and-statuses/)

> Understand the statuses a Verification moves through from creation to completion.