Skip to main content
POST
/
api
/
v1
/
auth
/
login
Login
curl --request POST \
  --url https://api.example.com/api/v1/auth/login \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "<string>"
}
'
{
  "message": "<string>",
  "email": "<string>",
  "error": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/lakshay-goyal/Exness/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

The login endpoint initiates the authentication flow for the Exness Trading Platform. When a user provides their email address, the system generates a JWT token containing the user’s credentials and sends a verification link via email.

​
Authentication Flow

  1. User submits email address to /api/v1/auth/login
  2. Server generates a unique user ID and creates a JWT token
  3. Verification email is sent with a token link
  4. User clicks the verification link to complete authentication via /api/v1/auth/verify

​
Request

​
email
string
required
The user’s email address. This will be used to send the verification link and is embedded in the JWT token.

​
Request Body Example

{
  "email": "trader@example.com"
}

​
Response

​
message
string
Confirmation message that the verification link was sent
​
email
string
Echo of the email address that received the verification link

​
Success Response (200 OK)

{
  "message": "Verification link send",
  "email": "trader@example.com"
}

​
Error Responses

​
error
string
Error message describing what went wrong

​
400 Bad Request

Returned when the email parameter is missing. 
{
  "error": "Email is required"
}

​
500 Internal Server Error

Returned when there’s a server configuration issue or processing failure. 
{
  "error": "Server configuration error"
}
or 
{
  "error": "Failed to process login request"
}

​
Implementation Details

  • Generates a unique UUID v4 for each user session
  • Creates a JWT token containing userId and email
  • In production: Sends verification email via nodemailer
  • In development: Logs verification link to console
  • Email sending failures don’t block the response (logged for debugging)

​
cURL Example

curl -X POST https://api.exness.com/api/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "email": "trader@example.com"
  }'

​
JavaScript Example

const response = await fetch('https://api.exness.com/api/v1/auth/login', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    email: 'trader@example.com'
  })
});

const data = await response.json();
console.log(data);
// { message: "Verification link send", email: "trader@example.com" }

​
Next Steps

After receiving the verification email, users should click the link which directs them to the verify endpoint to complete authentication and receive their JWT token for API access.