List User MFA Devices
List a given user's devices.
External Documentation
To learn more, visit the PingIdentity documentation.
Parameters
| Parameter | Description |
|---|---|
| Expand | Expand certain fields and return additional information when available. |
| User ID | The user's ID. Can be obtained by the List Users action. |
Example Output
{
"_links": {
"self": {
"href": "https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/users/8376797d-641c-4e7b-8bc1-2fdf71916cab/devices"
},
"devices.reorder": {
"href": "https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/users/8376797d-641c-4e7b-8bc1-2fdf71916cab/devices"
}
},
"_embedded": {
"devices": [
{
"_links": {
"self": {
"href": "https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/users/8376797d-641c-4e7b-8bc1-2fdf71916cab/devices/eaae1190-b42f-427c-bf92-d5fa5fd9c288"
},
"environment": {
"href": "https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6"
},
"user": {
"href": "https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/users/8376797d-641c-4e7b-8bc1-2fdf71916cab"
}
},
"id": "eaae1190-b42f-427c-bf92-d5fa5fd9c288",
"environment": {
"id": "abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6"
},
"user": {
"id": "8376797d-641c-4e7b-8bc1-2fdf71916cab"
},
"type": "SMS",
"nickname": "My phone",
"status": "ACTIVE",
"createdAt": "2020-10-30T19:42:02.562Z",
"updatedAt": "2020-12-16T22:04:31.284Z",
"phone": "15127881501"
},
{
"_links": {
"self": {
"href": "https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/users/8376797d-641c-4e7b-8bc1-2fdf71916cab/devices/b45713b4-1fbf-45b4-9fbf-54c32d63f0d6"
},
"environment": {
"href": "https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6"
},
"user": {
"href": "https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/users/8376797d-641c-4e7b-8bc1-2fdf71916cab"
}
},
"id": "b45713b4-1fbf-45b4-9fbf-54c32d63f0d6",
"environment": {
"id": "abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6"
},
"user": {
"id": "8376797d-641c-4e7b-8bc1-2fdf71916cab"
},
"type": "EMAIL",
"status": "ACTIVE",
"createdAt": "2020-10-30T19:39:25.180Z",
"updatedAt": "2020-10-30T19:39:25.180Z",
"email": "johnbudz@pingidentity.com"
},
{
"_links": {
"self": {
"href": "https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/users/8376797d-641c-4e7b-8bc1-2fdf71916cab/devices/09859da1-aed0-4be0-af1d-5583471b5d9c"
},
"environment": {
"href": "https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6"
},
"user": {
"href": "https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/users/8376797d-641c-4e7b-8bc1-2fdf71916cab"
},
"device.activate": {
"href": "https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/users/8376797d-641c-4e7b-8bc1-2fdf71916cab/devices/09859da1-aed0-4be0-af1d-5583471b5d9c"
}
},
"id": "09859da1-aed0-4be0-af1d-5583471b5d9c",
"environment": {
"id": "abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6"
},
"user": {
"id": "8376797d-641c-4e7b-8bc1-2fdf71916cab"
},
"type": "SECURITY_KEY",
"status": "ACTIVATION_REQUIRED",
"createdAt": "2020-10-29T19:30:08.768Z",
"updatedAt": "2020-10-29T19:30:08.768Z",
"rp": {
"id": "pingone.com"
}
},
{
"_links": {
"self": {
"href": "https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/users/8376797d-641c-4e7b-8bc1-2fdf71916cab/devices/3aee5588-db8f-4664-a637-97fbff757b81"
},
"environment": {
"href": "https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6"
},
"user": {
"href": "https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/users/8376797d-641c-4e7b-8bc1-2fdf71916cab"
},
"device.activate": {
"href": "https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/users/8376797d-641c-4e7b-8bc1-2fdf71916cab/devices/3aee5588-db8f-4664-a637-97fbff757b81"
}
},
"id": "3aee5588-db8f-4664-a637-97fbff757b81",
"environment": {
"id": "abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6"
},
"user": {
"id": "8376797d-641c-4e7b-8bc1-2fdf71916cab"
},
"type": "PLATFORM",
"status": "ACTIVATION_REQUIRED",
"createdAt": "2020-10-29T19:16:38.559Z",
"updatedAt": "2020-10-29T19:16:38.559Z",
"rp": {
"id": "pingone.com"
},
"platform": "BIOMETRICS"
},
{
"_links": {
"self": {
"href": "https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/users/8376797d-641c-4e7b-8bc1-2fdf71916cab/devices/ef1a087f-45b8-4003-9bdd-a19d5b7723fa"
},
"environment": {
"href": "https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6"
},
"user": {
"href": "https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/users/8376797d-641c-4e7b-8bc1-2fdf71916cab"
},
"device.activate": {
"href": "https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/users/8376797d-641c-4e7b-8bc1-2fdf71916cab/devices/ef1a087f-45b8-4003-9bdd-a19d5b7723fa"
}
},
"id": "ef1a087f-45b8-4003-9bdd-a19d5b7723fa",
"environment": {
"id": "abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6"
},
"user": {
"id": "8376797d-641c-4e7b-8bc1-2fdf71916cab"
},
"type": "PLATFORM",
"status": "ACTIVATION_REQUIRED",
"createdAt": "2020-10-29T19:07:25.907Z",
"updatedAt": "2020-10-29T19:07:25.907Z",
"rp": {
"id": "pingone.com"
},
"platform": "BIOMETRICS"
}
]
},
"count": 5,
"size": 5
}
Workflow Library Example
List User Mfa Devices with Pingidentity and Send Results Via Email
Preview this Workflow on desktop