Verify 2FA installation

PUT

/v2/user/mfa/verify_installation

Last modified:2025-09-01 18:52:30

This endpoint is integral to the Two-Factor Authentication (2FA) setup process.
Once the user initiates 2FA enablement and receives a verification code (via SMS OTP or TOTP),
this endpoint serves to validate the successful installation of the chosen 2FA method.

Users must submit the received code to confirm and complete the 2FA activation process.
Successful verification ensures a secure and accurate integration of 2FA for enhanced account security.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Query Params

Responses

🟢200OK

application/json

2FA verified

Body

🟠401Unauthorized

🟠422Parameter Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT '/v2/user/mfa/verify_installation?method&otp_attempt' \
--header 'Authorization: Bearer <token>' \
--header 'x-api-key: <api-key>'

Response Example

200 - sms_success

{
    "status": "verified"
}

Modified at 2025-09-01 18:52:30

Enable 2FA

Disable 2FA