---
title: "Start Identity Verification"
method: POST
path: "/accounts/{account_id}/identity_verification"
tags: ["Accounts: ID+V"]
---

# Start Identity Verification

`POST /accounts/{account_id}/identity_verification`

## Path parameters

- `account_id` string, required

## Headers

- `LMG-Data-Privacy-Access-Principal` string, required
- `LMG-Data-Privacy-Access-Justification` string, required

## Request body

- InitiateKYCRequest — An object describing client-side configuration for the identity verification process.
  - `redirect_success` string, uri, required — The redirect target that will be opened after a successful video-identification process.
  - `redirect_failure` string, uri, required — The redirect target that will be opened after a failed video-identification process.

## Response `200`

Successful Response

- InitiateKYCResponse — An object describing a pending video-identification process.
  - `url` string, uri, required — A web URL. Use this URL to present the user with the web version for initiating the video identification process. For different reasons, it may not be possible for the user to complete the video identification process on the mobile device. In this case, it is a good idea to offer a sharing option, e.g. so they can send the link to their own email address and complete the process on a different device. We expect these reasons (and others) to prevent the video identification process from completing: <ul> <li>Older devices that lack the resources (e.g. memory) to run the all of components involved at the same time. <li>Devices that are locked down for privacy reasons. This can both be company devices under MDM (mobile device management) or advanced used utiliting parental controls to block any access to the device's microphone and/or camera capabilities. </ul>
  - `video_ident_id` string, required — An identifier representing the process on the side of the video identification provider.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `422` — Unprocessable Entity
- `5XX` — Server Error

---

[API](https://skmtc.net/lemon/apis/lemon-markets-brokerage-api.md) · [All operations](https://skmtc.net/lemon/apis/lemon-markets-brokerage-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lemon/lemon-markets-brokerage-api/revisions/3c8cfd3a96c9/schema)