PingOne Recognize

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

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

Response 200

[
  {
    "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

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

Response 200

{
  "success": true
}