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
| Name | Description | Type | Additional information |
|---|---|---|---|
| usernameRecoveryUid | string |
Required |
Body Parameters
UsernameRecoveryOtpVerifyRequest| Name | Description | Type | Additional 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| Name | Description | Type | Additional 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>