Skip to main content

Authenticate User

POST /v2/auth/step

Authenticates users through a step-based verification process. First, submit the username to receive a verification code via email. Then submit the username with the code to complete authentication and receive session tokens for API access.

Request Body​

{
      "username": "user@example.com",
      "code": ""
  }

Usage Example​

First, send only the username. After receiving the verification code on a trusted device (e.g., email), include the code in the next request.

Request Example (Step 1: initiate)​

{
  "username": "user@example.com"
}

Response Example (Step 1)​

{
  "message": "Verify your factors",
  "data": {
    "type": "mail",
    "count": 1,
    "total": 1
  },
  "statusCode": 200
}

Request Example (Step 2: verify)​

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

Response Example (Step 2)​

{
  "message": "Authorized",
  "statusCode": 200
}