Sofar logo
Sofar logo
Api
Activate email OTP POSTActivate TOTP POSTGet active 2FA methods GETSet or reset email OTP POSTInitiate email OTP challenge POSTInitiate an email address transfer POSTSet or reset TOTP POSTTime until the next email OTP may be generated GETSend a password reset email POSTComplete an email address transfer PUTTime until the next recovery code guess GETDeactivate email OTP DELETEDeactivate TOTP DELETEReset the recovery codes of a user POSTSend a password reset OTP POSTTime until the next TOTP guess GETUpdate password via OTP PUTUpdate password via sudo token PUTCheck a password reset OTP POSTComplete email OTP challenge POSTVerify a recovery code POSTVerify TOTP code POST
User
GET
/user/2fa/totp/next-guess

Get the minimum time until the next TOTP guess may be made

Authorization

AuthorizationBearer <token>

A valid access token (proof of identity) can be obtained via the /accesstoken endpoint. It has a 5 minutes validity period.

In: header

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://authentication.eniris.be/user/2fa/totp/next-guess"
{
  "duration": 0
}
{
  "statusCode": 400,
  "error": "Bad Request",
  "message": "Invalid email address"
}
{
  "statusCode": 401,
  "error": "Unauthorized",
  "message": "NO_TOKEN_PROVIDED"
}
{
  "statusCode": 409,
  "error": "Conflict",
  "message": "TOTP_UNINITIALIZED"
}

Send a password reset OTP POST

Send a password reset OTP to an existing user. Wait at least 60 seconds between successive calls

Update password via OTP PUT

Change a user password, authenticating by providing an OTP