Nest Authbeta

GET /auth/mfa/devices

List registered MFA devices

List registered MFA devices

GET/auth/mfa/devices

Responses

200

Array of MfaDeviceDto

FieldTypeRequiredDescription
idstringrequiredUnique identifier of the MFA device
Example: 4b3c9c9c-9a9d-4d1e-8d9f-123456789abc
deviceNamestringrequiredFriendly name of the registered device
Example: Work laptop
method"email" | "sms" | "totp"requiredMFA method this device supports
emailsmstotp
Example: totp
lastUsedAtstring<date-time>optionalTimestamp of when the device was last used
Example: 2024-05-20T12:34:56.000Z
verifiedbooleanrequiredWhether the device setup has been verified
Example: true
createdAtstring<date-time>optionalTimestamp of when the device was registered
Example: 2024-05-18T10:15:00.000Z

Example response

[
  {
    "id": "4b3c9c9c-9a9d-4d1e-8d9f-123456789abc",
    "deviceName": "Work laptop",
    "method": "totp",
    "lastUsedAt": "2024-05-20T12:34:56.000Z",
    "verified": true,
    "createdAt": "2024-05-18T10:15:00.000Z"
  }
]

Try it

curl -X GET 'https://api.example.com/auth/mfa/devices' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

On this page