Skip to main content
Version: Latest (3.102.6)

Initiate verification

POST 
/verification-srv/authentication/:method/initiation

This API call is used to initiate the verification of the user depending on the type of verification configured.

This is a public API that requires no groups or roles but requires a valid request_id and identifier (email, mobile, or username) or medium_id. The information about the medium_id and which methods are available you retrieve in the verification List API. For more information about the authentication process, there is an overview for each verification method.

Validation Steps Performed:

  1. Validates request_id and usage_type are present and valid.
  2. Validates usage_type mapping to payload structure:
    • INITIAL_AUTHENTICATION: Requires identifier (email, mobile, or username).
    • MULTIFACTOR_AUTHENTICATION: Requires sub or masked_sub.
    • PASSWORDLESS_AUTHENTICATION: Requires sub or masked_sub.
  3. Validates usage_type is exactly one of the supported strings (case-sensitive, no spaces).
  4. Validates single_factor_auth is only allowed for FACE method.
  5. Validates verification method is allowed for the app and active/enabled.
  6. Validates masked sub (q or sub parameter) if provided.
  7. Validates user exists and physical verification is configured.
  8. Performs Fraud Detection System (FDS) checks and validates device/location details.

Request​

Responses​

SUCCESS