Skip to main content
GET
Retrieve Device Information

Authorizations

Authorization
string
header
required

Short-lived session token obtained from POST /api/sessions/v2. Send it as Authorization: Bearer <session_token> together with the X-Device-Key: <device-key> header identifying the target device.

Headers

X-Device-Key
string
required

Device Key (4 BIP39 words) identifying the target device. Obtain it from POST /device/otp/confirm/v2.

Pattern: ^[a-z]+-[a-z]+-[a-z]+-[a-z]+$
Example:

"alpha-bravo-charlie-delta"

Response

200 - application/json

OK

firmware_version
string
required

The firmware version of the device.

Example:

"1.0.0"

type
string
required

The type of the device.

Example:

"haptics-stroker-2000"

hardware_revision
string
required

The hardware revision of the device.

Example:

"1.0.0"

factory_activation_time
number
required

The factory activation time of the device. Epoch time in milliseconds.

Example:

1723251774000

serial_number
string
required

Device serial number. One-time write access on factory during registration.

Example:

"0000000000000001"

user_activation_time
number

The user activation time of the device. Epoch time in milliseconds.

Example:

1723251774000

firmware_status
enum<string>

Firmware update status.

Available options:
up-to-date,
update-available,
update-required
Example:

"up-to-date"