Retrieve unique identifier

POST

/device/retrieve-unique-identifier

Device

Retrieve device unique identifier.
It can accept creation command id's even if device was created via directory device creation endpoint.

Request

Header Params

X-DPT-AUTHORIZATION

string

required

Profile authorization token.

Example:

Body Params application/x-www-form-urlencoded

string

required

Example:

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://stage.privicore.com:9009/device/retrieve-unique-identifier' \
--header 'X-DPT-AUTHORIZATION;' \
--data-urlencode 'id='

Responses

🟢200OK

application/json

Body

deviceIdentifier

string

optional

Unique device identifier.

Example:

example_device_identifier

profileId

string

optional

Device profile id

Example:

device_profile_id

approved

optional

Allowed values:

truefalse

createdAt

string

optional

Created at.

Example:

2025-02-10T10:03:06+00:00

Example

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

🟠401Unauthorized

🟠422Parameter Error

Modified at 2025-03-06 13:01:35

Request unique identifier (i.e. Register new device)

Retrieve profile devices