Verify OTP and send recovered username(s) by SMS

Validates the SMS code (from /recover/username/request). When one or more AppUsers are linked to the verified recovery number, their username(s) are sent by SMS to that stored recovery phone in a single message. Legacy phone-number placeholders are never included; the response instead signals that migration is required. The API never returns usernames or the match count. When no account matches, the endpoint still returns the same success-shaped confirmation with a masked destination.

Access: Public endpoint.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required

international MSISDN that received the OTP. Must match the value passed to /recover/username/request.

string
required
length between 6 and 6
^\d{6}$

6-digit SMS code received on the MSISDN.

Responses

400

VALIDATION_FAILED — malformed request body or removed fields such as idNumber.

401

Invalid or expired OTP code.

502

OTP_DELIVERY_FAILED — recovery result SMS could not be sent after OTP verification. The FE may retry the recovery flow from /recover/username/request.

Language
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json