> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.trevex.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.trevex.io/_mcp/server.

# User Verification

When you call [`create_claim`](/api-reference/kyb-requests/create-claim) and the
response contains `user_verified: false`, TREVEX has started a verification
flow behind the scenes. **No further action is required from the partner.**

## What happens

#### Draft account created

TREVEX creates a draft account for the user keyed by `user_email`.

#### Verification email sent

An email with a secure link is sent to `user_email`.

#### User clicks the link

Their browser calls [`verify_account`](/api-reference/verification/verify-account)
with a one-time token. This endpoint is public by design.

#### Account activated

The draft is converted into a TREVEX account and a set-password email is
sent (link valid 48 hours).

#### KYB request unblocked

Every KYB request linked to this draft automatically moves from
`pending_verification` to `under_review`.

## Checking ahead of time

If you want to avoid the draft-account path entirely, call
[`user_lookup`](/api-reference/lookup/user-lookup) before submitting. If the user
exists and is verified, your `create_claim` response will come back with
`user_verified: true` immediately.

## What to show the end user

If `user_verified` is `false`, tell the user to check their inbox for a
verification email before the KYB request can be reviewed. A simple message works:

> **Info**
>
> We've sent a verification email to **[john.doe@example.com](mailto:john.doe@example.com)**. Please confirm
> your address to continue. Your KYB request will be reviewed automatically
> once verified.