Retrieve user MFA status

Retrieve user MFA status.

SecuritySecretApiKey or JWT
Request
path Parameters
id
required
string <= 50 characters ^[@~\-\.\w]+$

Resource identifier string.

Responses
200

User MFA status retrieved.

Response Schema: application/json
status
string

MFA enrollment status.

Enum: "active" "inactive"
type
string

MFA enrollment type. Type duo can't be updated or deleted. Contact support if you need to reset your Duo MFA.

Enum: "duo" "guardian"
lastAuthTime
string <date-time>

Last time MFA verification passed. To disable MFA it must be no more than 10 minutes before disable.

Array of Self (object) or EnrollmentLink (object) non-empty

Related resource links.

Array (non-empty)
Any of:
href
required
string

Link URL.

rel
required
string

Type of link.

Value: "self"
401

Unauthorized access. Invalid credentials used.

403

Access forbidden.

404

Resource not found.

get/users/{id}/mfa
Request samples
const mfa = await api.users.get({id: 'foobar-001'});
console.log(mfa.fields.status, mfa.fields.type, mfa.fields.lastAuthTime);
Response samples
application/json
{
  • "status": "active",
  • "type": "duo",
  • "lastAuthTime": "2019-08-24T14:15:22Z",
  • "_links": [
    ]
}