---
title: "Get MFA Status"
method: GET
path: "/v1/users/{id}/mfa"
tags: ["MFA API"]
---

# Get MFA Status

`GET /v1/users/{id}/mfa`

Use this endpoint to retrieve the current MFA configuration and status for a user.

## Path parameters

- `id` string, required

## Response `200`

MFA status and configuration for the user.

- MFAStatusResponse — The current MFA configuration and status for a user.
  - `enabled` boolean — Indicates whether MFA is enabled for the user.
  - `preferredType` 'app' | 'email' | 'sms' — The user's preferred MFA method.
  - `methods` string[] — List of MFA methods currently enabled for the user.
  - `totpEnabled` boolean — Indicates whether app-based TOTP MFA is enabled.
  - `emailEnabled` boolean — Indicates whether email-based MFA is enabled.
  - `smsEnabled` boolean — Indicates whether SMS-based MFA is enabled.

## Other responses

- `400`
- `404`
- `500`

---

[API](https://skmtc.net/lerian/apis/identity-plugin.md) · [All operations](https://skmtc.net/lerian/apis/identity-plugin/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lerian/identity-plugin/versions/25daba385532/schema)
