Skip to content

Login User

Authenticate a user and receive an access token.

Endpoint

POST /v1/accounts/login/

Authentication

Not required (public endpoint)

Request Body

{
  "email": "john.doe@example.com",
  "password": "SecurePass123!"
}

Parameters

Field Type Required Description Validation
email string Yes User's email address Valid email format
password string Yes User's password Not empty

Response

Success (200 OK)

{
  "access_token": "encrypted_token_string",
  "user": {
    "id": 1,
    "first_name": "John",
    "last_name": "Doe",
    "email": "john.doe@example.com",
    "phone": "+994501234567",
    "profile_photo": "",
    "preferred_language": "AZERBAIJANI",
    "role": "1",
    "created": "2025-01-15T10:30:00Z"
  }
}

Error Responses

Invalid Credentials (401)

{
  "error": "Invalid credentials"
}

Account Not Active (403)

When a user account exists but is not active (OTP not verified), the system automatically generates and sends a new OTP to the user's email.

{
  "error": "If an account exists and requires activation, an OTP has been sent."
}

Note: The OTP is automatically sent to the user's email. The user must verify the OTP using the Check OTP User endpoint before they can login.

Rate Limited (429)

If an OTP was requested within the last minute, the system will rate limit the request:

{
  "error": "Please wait before requesting another OTP"
}

Note: Wait at least 1 minute between OTP requests.

Example Request

curl -X POST "https://api.luxmart.site/v1/accounts/login/" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "john.doe@example.com",
    "password": "SecurePass123!"
  }'

Notes

  • Only users with role "1" (User) can login via this endpoint
  • User must be active (is_active: true) to login
  • If account is not active, a new OTP is automatically generated and sent via email
  • OTP requests are rate-limited to once per minute per account
  • Token expires after 30 days of inactivity
  • Use the access_token in the Authorization header for protected endpoints