Skip to main content

Complete Registration Flow

POST /v1/auth/verify

Finalizes a user's registration by validating the one-time verification code delivered via email. The endpoint checks that the code matches what was sent during the initial registration step. On successful validation, the user account is activated, the user is automatically logged in, and a session token with session metadata is returned for immediate use.

Query Parameters​

  • register - Parameter for register

Request Example​

POST /v1/auth/verify?register=true

Request Body​

{
    "username": "user@example.com",
    "mail": "123456"
  }

Response Example​

{
  "message": "Successfully completed registration, and logged in to the platform",
  "sessiontoken": "<session_token_placeholder>",
  "data": {
    "hash": "<bcrypt_hash_placeholder>",
    "expiration": "2025-10-24T10:15:23.320Z",
    "userId": "user-id-1",
    "tenant": null,
    "details": {
      "ua": "",
      "ip": "0.0.0.0",
      "browser": {
        "name": "Unknown",
        "version": "0.0"
      },
      "os": {
        "name": "Unknown",
        "version": "0.0"
      }
    },
    "_id": "session-id-1",
    "created": "2025-10-23T10:15:23.564Z",
    "updated": "2025-10-23T10:15:23.564Z",
    "__v": 0,
    "id": "session-id-1"
  }
}