Consumer Authentication

/

Frontend SDKs

/

Headless

/

Passwords

/

Strength Check

Strength check

The strengthCheck method wraps the Strength Check Password API endpoint.

This method allows you to check whether or not the user’s provided password is valid, and to provide feedback to the user on how to increase the strength of their password. All passwords must pass the strength requirements to be accepted as valid.


Method parameters


password*string

emailstring

Response fields


request_idstring

status_codeint

breach_detection_on_createboolean

breached_passwordboolean

scoreint

strength_policystring

valid_passwordboolean
import React, { useCallback } from 'react';
import { useStytch } from '@stytch/react';

export const Login = () => {
  const stytch = useStytch();

  const strengthCheck = useCallback(() => {
    stytch.passwords.strengthCheck({
      email: '${exampleEmail}',
      password: '$B&M)3$B$eCk_2@c',
    });
  }, [stytch]);

  return <button onClick={strengthCheck}>Strength Check</button>;
};

RESPONSE

200 - LUDS invalid
{
    "breach_detection_on_create": true,
    "breached_password": false,
    "feedback": {
      "suggestions": null,
      "warning": null,
      "luds_requirements": {
        "has_digit": true,
        "has_lower_case": false,
        "has_symbol": false,
        "has_upper_case": false,
        "missing_characters": 6,
        "missing_complexity": 1
      }
    },
    "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
    "score": 0,
    "status_code": 200,
    "strength_policy": "luds",
    "valid_password": false
}