POST api/bfg/v1/persons/username-recovery/{usernameRecoveryUid}/otp/verify

Checks the SMS one-time password and completes the recovery. Success is the hard block: a later request for that mobile returns 403 REQUEST_NOT_ALLOWED. A wrong or rejected code returns 400 with isSuccess false, an error code, and the current OTP detail. A locked session returns 403 SESSION_LOCKED.

Request Information

URI Parameters

NameDescriptionTypeAdditional information
usernameRecoveryUid

string

Required

Body Parameters

UsernameRecoveryOtpVerifyRequest
NameDescriptionTypeAdditional information
code

string

None.

Request Formats

application/json, text/json

Sample:
{
  "code": "sample string 1"
}

application/xml, text/xml

Sample:
<UsernameRecoveryOtpVerifyRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/TPP.B2B.Webservices2.Contracts2.BFG.UsernameRecovery">
  <code>sample string 1</code>
</UsernameRecoveryOtpVerifyRequest>

Response Information

Resource Description

UsernameRecoveryOtpVerifyResponse
NameDescriptionTypeAdditional information
isSuccess

boolean

None.

firstName

string

None.

username

string

None.

otpVerification

UsernameRecoveryOTPVerificationIssueResponse

None.

errorCode

string

None.

errorMessage

string

None.

Response Formats

application/json, text/json

Sample:
{
  "isSuccess": true,
  "firstName": "sample string 2",
  "username": "sample string 3",
  "otpVerification": {
    "sentToMobile": "sample string 1",
    "expiresAtUtc": "2026-11-16T17:51:42.0687493+11:00",
    "issueCount": 3,
    "issuesRemaining": 4,
    "attemptCount": 5,
    "attemptsRemaining": 6,
    "cooldownSeconds": 7
  },
  "errorCode": "sample string 4",
  "errorMessage": "sample string 5"
}

application/xml, text/xml

Sample:
<UsernameRecoveryOtpVerifyResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/TPP.B2B.Webservices2.Contracts2.BFG.UsernameRecovery">
  <errorCode>sample string 4</errorCode>
  <errorMessage>sample string 5</errorMessage>
  <firstName>sample string 2</firstName>
  <isSuccess>true</isSuccess>
  <otpVerification>
    <attemptCount>5</attemptCount>
    <attemptsRemaining>6</attemptsRemaining>
    <cooldownSeconds>7</cooldownSeconds>
    <expiresAtUtc>2026-11-16T17:51:42.0687493+11:00</expiresAtUtc>
    <issueCount>3</issueCount>
    <issuesRemaining>4</issuesRemaining>
    <sentToMobile>sample string 1</sentToMobile>
  </otpVerification>
  <username>sample string 3</username>
</UsernameRecoveryOtpVerifyResponse>