Validation

Validate Activation / Verification Code

This API validates a one-time verification code submitted by a user and executes the corresponding account operation based on the specified mode.

Depending on the mode, the API may:

Activate a newly registered account

Confirm a login attempt

Verify a password change or reset

Validate email or mobile updates

Confirm account deletion or clearing requests

The API verifies the provided activation_code against the given user_id, mode, and application context.
If validation succeeds, the requested operation is completed and the API returns the relevant POD information and user profile details (where applicable).

If validation fails, the operation is not performed and an appropriate error response is returned.

Authentication

This endpoint requires Bearer Token authentication.

Header

Authorization: Bearer <access_token>

Request Body

{
  "user_id": "string",
  "activation_code": "string",
  "app_id": "string",
  "mode": "string"
}

Field Descriptions

user_id – Unique identifier of the user initiating the operation

activation_code – One-time verification code sent to the user

app_id – Application identifier (optional or context-specific)

mode – Operation context for which the verification is being performed

Usage Scenarios (Mode Definitions)

Mode	Purpose
0	Email or mobile number change
1	Password change
2	Delete account
3	Clear account
4	Signup verification (account activation)
5	Login verification
6	Forgot password verification

Successful Response

On successful validation:

The requested operation (based on mode) is completed

The API returns:

POD information associated with the user (if applicable)

User profile details (if applicable)

Examples:

For signup verification, the user account is activated

For login, access is confirmed

For password reset, the user may proceed to set a new password

For account deletion, the request is confirmed

Error Response

The API returns an error response when:

The activation code is invalid or expired

The activation code does not match the user or operation mode

The requested operation is already completed (e.g., user already activated)

Authorization fails or the bearer token is missing or invalid

⚠️ In all error cases, no account state change occurs.

One-Line Summary

Validates a one-time verification code and securely completes the requested user account operation (signup, login, password change, or account actions), returning POD and profile details on success.

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Validate Activation / Verification Code#

Authentication#

Request Body#

Field Descriptions#

Usage Scenarios (Mode Definitions)#

Successful Response#

Error Response#

One-Line Summary#

Request

Responses