---
title: "Start Journey"
method: POST
path: "/v2/start-journey"
---

# Start Journey

`POST /v2/start-journey`

Start a new journey from backend server.

## Request body

- object
  - `flow_id` string, required — The flow_id to be used to apply your customised business rules on the submission.
  - `reference_no` string — The reference number. (AKA userId)
  - `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)

## Response `200`

200

- object
  - `journey_summary` object
    - `journey_id` string
    - `is_completed` boolean
    - `step_summaries` object[]
      - `definition` object
      - `result` object
        - `has_passed_rules` unknown
        - `is_concluded` boolean
        - `status` string
        - `error_user_feedback_code` string
        - `error_user_feedback_title` string
        - `error_user_feedback_details` 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)