Retrieve unique identifier

Overview

Retrieve the unique identifier assigned to a device registration request. This endpoint works for devices created through the standard registration flow or via directory device creation.

Retrieve Unique Identifier

Endpoint: POST /device/retrieve-unique-identifier

Authentication: Required (Authorization token obtained from the step)

Use Case

After requesting device registration, use this endpoint to retrieve the unique identifier assigned to the device. This identifier is required for subsequent device configuration steps, including public key registration and metadata configuration.

The endpoint accepts creation command IDs from both the standard device registration flow and the directory device creation endpoint, providing flexibility in device provisioning workflows.

Retrieves the device identifier assigned during registration
Works with identifiers from multiple device creation methods
The identifier is required for completing device setup
Store the identifier securely for device management operations

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

application/json

Bodyapplication/json

Example

{
    "deviceIdentifier": "example_device_identifier",
    "profileId": "device_profile_id",
    "approved": true,
    "createdAt": "2025-02-10T10:03:06+00:00"
}

Retrieve unique identifier

Overview#