---
title: "Login Totp"
method: POST
path: "/auth/login-totp"
tags: ["General APIs with JWT"]
---

# Login Totp

`POST /auth/login-totp`

## Request

- Base URL: `https://lium.io/api`
- URL: `https://lium.io/api/auth/login-totp`
- Auth: none declared

The second step of a sign-in that answered `mfa_required`: its `mfa_token` and an authenticator or recovery
code give the normal login answer.

## Request body

- TotpLoginRequest
  - `mfa_token` string, required
  - `code` string, required

## Response `200`

Successful Response

- LoginResponseDto
  - `user` UserResponseDto, required: The user account in the shape a client may see. Endpoints that hand a User row back go through this DTO, so the bcrypt hash never leaves the server. The signup forensics — ``ip_address``, ``signup_attribution``, ``referred_by_miner_id``, ``referred_by_code_id`` — stay out for the same reason: no client reads them (``GET /users/me`` shows the partner code itself as ``referred_by``, built by ``UserService.get_user_info``).
    - `id` string, uuid, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, nullable, required
    - `name` string, required
    - `email` string, nullable, required
    - `stripe_customer_id` string, nullable, required
    - `stripe_connect_account_id` string, nullable, required
    - `stripe_onboarding_completed` boolean, nullable, required
    - `referral_payout_method` 'balance' | 'usd' | 'crypto', required
    - `referral_payout_wallet_id` string, uuid, nullable, required
    - `balance` number, nullable, required
    - `pending_referral_balance` number, nullable, required
    - `email_verified` boolean, nullable, required
    - `pending_email` string, nullable
    - `avatar_url` string, nullable, required
    - `company_name` string, nullable, required
    - `discord_id` string, nullable, required
    - `disable_incoming_connections` boolean, required
    - `deleted_at` string, date-time, nullable, required
    - `validator_hotkey` string, nullable, required
    - `archive_hints` string[], nullable, required
    - `admin` boolean, nullable, required
    - `internal_member` boolean, nullable, required
    - `referral_code` string, nullable, required
    - `totp_enabled` boolean
  - `token` string, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-11-12** `ea95bc2e1a0f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/lium/apis/lium-backend-api/changes/auth/login-totp/post.md)

---

[API](https://skmtc.dev/lium/apis/lium-backend-api.md) - [All operations](https://skmtc.dev/lium/apis/lium-backend-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lium/apis/lium-backend-api/revisions/e13b07d90cfc?raw)
