View Categories

Check user status

< 1 min read

Table of Contents

Check User Status #

Returns the current verification state of a user and drives the onboarding decision tree.

Endpoint #

GET https://api-test.10npay.com/User/{id}/status

Headers #

  • Authorization: Bearer <access_token>
  • Accept: application/json

Path Parameters #

Name Type Description
id integer (int32) The userId returned by POST /User. Range 1..2147483647.

Response — 200 OK #

{
  "isEmailVerified": false,
  "isPhoneNumberVerified": false,
  "isScaVerified": false,
  "isAdditionalData": false,
  "isOptionalKyc": false,
  "status": 50
}

Field Reference #

Field Description
isEmailVerified Email confirmed via POST /User/email/confirm.
isPhoneNumberVerified Phone confirmed via POST /User/phone-number/verify.
isScaVerified User has been provisioned inside the SCA application.
isAdditionalData Additional onboarding questionnaire submitted.
isOptionalKyc Optional KYC (if applicable) completed.
status Lifecycle code (50 Registered, 150 PendingVerification, 200 Active, 300 Deactivated, 350 Closed, 400 Blocked).

Errors #

  • 401 Unauthorized — missing or expired Bearer token.
  • 404 Not Found — unknown userId.
  • 5xx Server Error — transient gateway failure (retry with backoff).

Usage Notes #

  • Poll this endpoint until status == 200 and every required flag is true; use it to decide which onboarding step to show next.
  • Safe to call multiple times; the state is derived server-side.
  • Downstream the Gateway forwards the call to the internal /app/user-status handler, so the response contract matches the wallet client.
What are your Feelings