---
title: "Create Verification Link"
method: POST
path: "/v2/verification-links"
---

# Create Verification Link

`POST /v2/verification-links`

## Request body

- object
  - `flow_id` string, required — The flow id.
  - `reference_no` string, required — The reference number. (AKA userId)
  - `locale` string — Tailors the output to specific language preferences.
  - `applicant_details` object — (optional) only for AML journeys.The applicant object, only full name is mandatory, and birth date and sex are optional parameters
    - `full_name` string, required — The full name of the applicant.
    - `birth_date` string, date — The birth date of the applicant.
    - `sex` string — `male` or `female`
    - `address` string — The full address of the applicant.
    - `flag_for_review` boolean — To flag the journey for further review (Refer)
  - `validity_duration` integer — Value in Minutes Default expiry duration: 60 minutes.
  - `redirection_url` string — (optional) The URL to which the user is redirected after the journey is completed.

## Response `200`

200

- object
  - `url` string

## Other responses

- `400` — 400
- `401` — 401
- `403` — 403
- `404` — 404
- `500` — 500

---

[API](https://skmtc.net/idwise/apis/idwise-api.md) · [All operations](https://skmtc.net/idwise/apis/idwise-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/idwise/idwise-api/versions/c83866525ec0/schema)