---
title: Devices
description: The Devices endpoints of the PingOne Recognize Mobile SDK Server API let you manage PingOne Recognize devices.
component: recognize
page_id: recognize:mobile-sdk:mobile-sdk-server-api-devices
canonical_url: https://docs.pingidentity.com/recognize/mobile-sdk/mobile-sdk-server-api-devices.html
llms_txt: https://docs.pingidentity.com/recognize/llms.txt
docs_for_agents: https://developer.pingidentity.com/build-with-ai/docs-for-agents.md
revdate: May 5, 2026
section_ids:
  endpoint-user-devices-get: GET /users/{userId}/devices
  path-params-user-devices-get: Path parameters
  responses-user-devices-get: Responses
  example-user-devices-get: Example
  endpoint-user-device-delete: DELETE /users/{userId}/devices/{publicSigningKey}
  path-params-user-device-delete: Path parameters
  responses-user-device-delete: Responses
  example-user-device-delete: Example
---

# Devices

All endpoints require the `X-Api-Key` header for authentication, which should contain your PingOne Recognize authorization key. For help, contact Support.

## GET /users/{userId}/devices

List devices for a user

Retrieve all devices registered to the specified user.

### Path parameters

| Name                  | Type           | Description                                   |
| --------------------- | -------------- | --------------------------------------------- |
| `userId` **required** | `string (HEX)` | Uppercase HEX string representing the user ID |

### Responses

| Status                  | Description                                                                                                                                                                                    |
| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `200`                   | Array of `UserDeviceResponse` — each with `userId`, `sdkCustomerId`, `publicSigningKey`, `publicEncryptionKey`, `state`, `createdAt`, plus optional `osVersion`, `sdkVersion`, and `deletedAt` |
| `400 / 401 / 404 / 406` | Standard error responses                                                                                                                                                                       |
| `500`                   | Internal server error                                                                                                                                                                          |

### Example

**Request**

```none
GET /v2/users/A1B2C3D4E5F6/devices
X-Api-Key: your-api-key
```

**Response 200**

```json
[
  {
    "userId": "A1B2C3D4E5F6",
    "sdkCustomerId": 42,
    "publicSigningKey": "BNyb8+dT4NdEf5IUdwwIC3mc...",
    "publicEncryptionKey": "LS0tLS1CRUdJTiBQVUJMSUMg...",
    "state": "ACTIVE",
    "createdAt": "2025-01-15T09:00:00.000",
    "osVersion": "iOS 17.4",
    "sdkVersion": "2.32.0"
  }
]
```

***

## DELETE /users/{userId}/devices/{publicSigningKey}

Delete a device

Delete a specific device belonging to the user, identified by its public signing key.

### Path parameters

| Name                            | Type           | Description                                   |
| ------------------------------- | -------------- | --------------------------------------------- |
| `userId` **required**           | `string (HEX)` | Uppercase HEX string representing the user ID |
| `publicSigningKey` **required** | `string`       | Device's public signing key                   |

### Responses

| Status                  | Description                                    |
| ----------------------- | ---------------------------------------------- |
| `200`                   | Device deleted — returns `{ "success": true }` |
| `400 / 401 / 404 / 406` | Standard error responses                       |
| `500`                   | Internal server error                          |

### Example

**Request**

```none
DELETE /v2/users/A1B2C3D4E5F6/devices/BNyb8%2BdT4NdEf5IUdwwIC3mc
X-Api-Key: your-api-key
```

**Response 200**

```json
{
  "success": true
}
```