> For the complete documentation index, see [llms.txt](https://docs.loopit.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.loopit.co/people-companies/trupass/authenticate-mvr.md).

# Authenticate MVR

### What is an MVR check?

An MVR check pulls the official record for a US driver licence from the state DMV. It tells you whether the licence is **valid** or **revoked**, and returns any violations on record.

This is useful when you want to verify a customer's driving history before confirming or activating a booking.

> **US licences only.** Authenticate MVR is only available for United States driver licences.

***

### Setting it up

1. Go to **Settings → Integrations**
2. Find **Authenticate MVR** and click to configure it
3. Enter the **details**
4. Save

Once enabled, the MVR check option will appear on customer licence pages and in booking requirements.

***

### Requiring an MVR check for bookings

An MVR check can be set as a condition that must be met before a booking can move forward.

1. Go to **Settings → Booking Rules → Requirements**
2. Enable **Authenticate MVR**
3. Choose at which stage it must be completed — **Confirmed**, or **Active**

Once set, the booking overview shows the MVR check status for each driver. If the check hasn't passed, the booking will be flagged and auto-activation will be blocked.

***

### Running a check

1. Go to the customer's profile and open the **TruPass** tab
2. Select their US driver licence
3. Click **New MVR check**
4. Review the customer's details — anything missing will be highlighted in red
5. Confirm that the customer has given their consent and click **Send**

The result appears straight away — **Passed** or **Failed**.

#### What information is needed?

The following must be on the customer's licence record in Loopit before a check can be run:

* Licence number
* State (e.g. FL, CA)
* Expiry date
* Date of birth
* First name, last name, and email address

If anything is missing, the system will tell you before you submit.

***

### Understanding the result

| Result     | What it means                                                       |
| ---------- | ------------------------------------------------------------------- |
| **Passed** | Licence is valid — the customer is clear to proceed                 |
| **Failed** | Licence is revoked, not found, or there was an issue with the check |

Once a check passes, the licence is automatically **locked** in Loopit to prevent the details from being changed after verification.

***

### Notifications & automation

Automated emails and workflows can be configured to fire when an MVR check completes.

#### Email templates

Go to **Settings → Email Templates**, create a new template, and select **Authenticate MVR Check** as the module. The email can be personalised using tags like the customer's name, licence details, and check result.

#### Workflows

Go to **Settings → Workflows** and use any of these triggers:

* **Authenticate MVR check is processing** — fires when a check is submitted
* **Authenticate MVR check passes** — fires when the result is valid
* **Authenticate MVR check fails** — fires when the result is revoked or not found

A common setup is to automatically send a notification email to the customer when their check passes or fails.
