Sign-in

Verify with biometrics

Signs in a user with biometrics instead of a password. Pass the email they enrolled with; if it matches, Weavr sends a push notification to their enrolled device asking them to authenticate biometrically.

Because the user has already completed a second factor, the token you get back is stepped up. You can use it straight away for endpoints and UI components that require step-up, with no separate step-up challenge.

The device must have been enrolled beforehand through /authentication_factors/push/{channel}. For the password flow, see Sign in with a password.

post/login_via_biometrics

Request

  • Base URL: https://sandbox.weavr.io/multi
  • URL: https://sandbox.weavr.io/multi/login_via_biometrics
  • Auth: API key in header api-key

Request body

emailstring email required

Email Address of the user

Example request

{
  "email": "alex@example.com",
  "identity": {
    "type": "CONSUMER",
    "id": "123456789"
  }
}

Response

Success

challengeIdstring

The unique identifier of a Biometric challenge.

Changes

No recorded changes to this operation across all 1 revision of this API.