---
title: List registered devices over REST
description: AM provides a REST API to retrieve information about MFA devices registered to a user.
component: pingam
version: 8.1
page_id: pingam:am-authentication:authn-mfa-list-devices
canonical_url: https://docs.pingidentity.com/pingam/8.1/am-authentication/authn-mfa-list-devices.html
keywords: ["Authentication", "Multi-factor Authentication (MFA)"]
page_aliases: ["authentication-guide:authn-mfa-list-devices.adoc"]
section_ids:
  list_oath_devices: List OATH devices
  list_push_devices: List push devices
  list_webauthn_devices: List WebAuthn devices
  list_bound_devices: List bound devices
---

# List registered devices over REST

AM provides a REST API to retrieve information about MFA devices registered to a user.

When making a REST API call, specify the realm in the path component of the endpoint. You must specify the entire hierarchy of the realm, starting at the Top Level Realm. Prefix each realm in the hierarchy with the `realms/` keyword. For example, `/realms/root/realms/customers/realms/europe`.

## List OATH devices

To retrieve the list of OATH devices registered to a user, query the `users/user/devices/2fa/oath` endpoint.

The following example lists the OATH devices for a user named `bjensen` in a realm called `alpha`:

```bash
$ curl \
--request GET \
--header "iPlanetDirectoryPro: AQIC5w…​2NzEz*" \
'https://am.example.com:8443/am/json/realms/root/realms/alpha/users/bjensen/devices/2fa/oath?_queryFilter=true'
{
  "result" : [
    {
      "_id" : "ff1db8bf-d2d7-46e1-926a-568b877f87a5",
      "_rev" : "172031596",
      "createdDate": 1749572704744,
      "lastAccessDate": 1749658650801,
      "deviceName" : "OATH Device",
      "uuid" : "ff1db8bf-d2d7-46e1-926a-568b877f87a5",
      "deviceManagementStatus" : false
    }
  ],
  "resultCount" : 1,
  "pagedResultsCookie" : null,
  "totalPagedResultsPolicy" : "NONE",
  "totalPagedResults" : -1,
  "remainingPagedResults" : -1
}
```

## List push devices

To retrieve the list of push devices registered to a user, query the `users/user/devices/2fa/push` endpoint.

The following example lists the push devices for a user named `bjensen` in a realm called `alpha`:

```bash
$ curl \
--request GET \
--header "iPlanetDirectoryPro: AQIC5w…​2NzEz*" \
'https://am.example.com:8443/am/json/realms/root/realms/alpha/users/bjensen/devices/2fa/push?_queryFilter=true'
{
  "result" : [
    {
      "_id" : "ff1db8bf-d2d7-46e1-926a-568b877f87a5",
      "_rev" : "172031596",
      "createdDate": 1749572704744,
      "lastAccessDate": 1749658650801,
      "deviceName" : "Push Device",
      "uuid" : "ff1db8bf-d2d7-46e1-926a-568b877f87a5",
      "deviceManagementStatus" : false
    }
  ],
  "resultCount" : 1,
  "pagedResultsCookie" : null,
  "totalPagedResultsPolicy" : "NONE",
  "totalPagedResults" : -1,
  "remainingPagedResults" : -1
}
```

## List WebAuthn devices

To return a list of WebAuthn devices registered to a user, query the `users/user/devices/2fa/webauthn` endpoint.

The following example lists the WebAuthn devices for a user named `bjensen` in a realm called `alpha`:

```bash
$ curl \
--request GET \
--header "iPlanetDirectoryPro: AQIC5w…​2NzEz*" \
'https://am.example.com:8443/am/json/realms/root/realms/alpha/users/bjensen/devices/2fa/webauthn?_queryFilter=true'
{
  "result": [
    {
      "_id": "ff1db8bf-d2d7-46e1-926a-568b877f87a5",
      "_rev": "163664231",
      "createdDate": 1749572704744,
      "lastAccessDate": 1749658650801,
      "credentialId": "XGJpYNYv4AHG9sHHgxFfTw",
      "deviceName": "New Security Key",
      "uuid": "ff1db8bf-d2d7-46e1-926a-568b877f87a5",
      "deviceManagementStatus": false
    }
  ],
  "resultCount": 1,
  "pagedResultsCookie": null,
  "totalPagedResultsPolicy": "NONE",
  "totalPagedResults": -1,
  "remainingPagedResults": -1
}
```

## List bound devices

To return a list of bound devices for a user, query the `users/user/devices/2fa/binding` endpoint. Learn more about binding devices to a user profile in [device binding](https://docs.pingidentity.com/sdks/latest/sdks/use-cases/how-to-bind-devices.html).

The following example lists the bound devices for a user named `bjensen` in a realm called `alpha`:

```bash
$ curl \
--request GET \
--header "iPlanetDirectoryPro: AQIC5w…​2NzEz*" \
'https://am.example.com:8443/am/json/realms/root/realms/alpha/users/bjensen/devices/2fa/binding?_queryFilter=true'
{
  "result": [
    {
      "_id": "ff1db8bf-d2d7-46e1-926a-568b877f87a5",
      "_rev": "192142989",
      "createdDate": 1749572704744,
      "lastAccessDate": 1749658650801,
      "deviceId": "e2e84b5d2a927abdcb85570bac9701c390a92751",
      "deviceName": "iOS Device",
      "uuid": "ff1db8bf-d2d7-46e1-926a-568b877f87a5",
      "deviceManagementStatus": false
    }
  ],
  "resultCount": 1,
  "pagedResultsCookie": null,
  "totalPagedResultsPolicy": "NONE",
  "totalPagedResults": -1,
  "remainingPagedResults": -1
}
```