Verify legacy phone and PIN

Authenticates a legacy megsApp subscriber by MSISDN + PIN. On success returns a 10-minute migration JWT and the legacy first/last name so the client can pre-fill the email/password setup screen. The migration token is the bearer required by POST /app-user/migrate/complete.

Access: Public endpoint.

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

MSISDN. Common SA local form (0716054142), +international, and digits-only international format are normalised to digits-only international format before lookup.

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

Legacy megsApp PIN — exactly 6 numeric digits.

Responses

401

INVALID_PIN — PIN does not match. attemptsRemaining indicates how many failures remain before lockout (or null when the lockout flag is off).

404

MSISDN_NOT_FOUND — no legacy user exists for this MSISDN.

409

MSISDN_ALREADY_MIGRATED — this MSISDN has already migrated.

429

PIN_LOCKED — too many failed attempts. retryAfterSec indicates when the lockout window expires.

503

MIGRATION_PIN_VERIFICATION_UNAVAILABLE - PIN verification is temporarily unavailable. Please try again later.

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