1. Docs
  2. API Reference
  3. MfaTotpEnrollVerifyResponseDto

The MfaTotpEnrollVerifyResponseDto object

Example

{
  "factor": {
    "id": "00000000-0000-0000-0000-000000000000",
    "type": "totp",
    "label": "iPhone 15",
    "enrolled_at": "2026-04-20T12:00:00.000Z",
    "last_used_at": "2026-04-20T12:00:00.000Z"
  },
  "recovery_codes": [
    "ABCD-EFGH-IJKL-MNOP",
    "QRST-UVWX-YZ23-4567",
    "..."
  ],
  "recovery_codes_generation": 0
}

Properties

  • factorMfaFactorResponseDto*
  • recovery_codesstring[]*

    Ten single-use recovery codes. **Shown exactly once** — the server only stores hashes. Display, allow copy/download, and proceed only after the user confirms they have saved them.

  • recovery_codes_generationnumber*

    Monotonically-increasing generation number for this batch. Used by the portal admin surface to show "X of 10 remaining" against the current batch.