1. Docs
  2. API Reference
  3. MfaTotpEnrollVerifyResponseDto

MfaTotpEnrollVerifyResponseDto

Example

JSON
{
  "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",
    "webauthn_rp_id": "acme.com"
  },
  "recovery_codes": [
    "ABCD-EFGH-IJKL-MNOP",
    "QRST-UVWX-YZ23-4567",
    "..."
  ],
  "recovery_codes_generation": 0
}

Properties

3 properties 3 required

factor MfaFactorResponseDto Required
recovery_codes array of string Required

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.

ExampleABCD-EFGH-IJKL-MNOPQRST-UVWX-YZ23-4567...
recovery_codes_generation number Required

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

Was this page helpful?

Tell us how we can improve this guide.