Get Command Result

Retrieve the current status and final result by command ID. The platform does not provide a command-history list. Store data.command.id from each device-operation response. Command records are retained for approximately 48 hours.

Endpoint

GET /wlte/v1/commands/{commandId}

Permission

Scope	Required	Description
device:read	Yes	Read a command result

Relay Command Example

{
  "code": "SUCCESS",
  "message": "OK.",
  "requestId": "req_001",
  "data": {
    "id": "cmd_001",
    "deviceId": "abc123456789",
    "operation": "device.relay.set",
    "status": "SUCCESS",
    "params": {
      "relays": [
        { "index": 1, "action": "ON" },
        { "index": 2, "action": "OFF" }
      ]
    },
    "createdAt": "2026-07-15T08:30:00Z"
  }
}

RS485 Command Example

{
  "code": "SUCCESS",
  "message": "OK.",
  "requestId": "req_002",
  "data": {
    "id": "cmd_002",
    "deviceId": "rek053537488",
    "operation": "device.rs485.transceive",
    "status": "SUCCESS",
    "params": {
      "requestHex": "02060034000109F7"
    },
    "result": {
      "responseHex": "02060034000109F7"
    },
    "createdAt": "2026-07-15T08:30:00Z"
  }
}

result is normally omitted for TIMEOUT.

Command Object

Field	Type	Required	Description
id	string	Yes	Command ID
deviceId	string	Yes	Device identifier
operation	string	Yes	Public operation name
status	string	Yes	SENT, SUCCESS, FAILED, or TIMEOUT
params	object	No	Normalized request parameters
result	object	No	Device-confirmed result; may be absent on timeout or failure
createdAt	string	Yes	Command creation time in RFC3339 UTC

Current operation values include:

• device.relay.set
• device.rs485.transceive
• device.rs485.baudRate.set
• device.relay.jogConfig.set

Polling Guidance

• Poll this endpoint when the initial status is SENT.
• SUCCESS, FAILED, and TIMEOUT are terminal.
• After 429 RATE_LIMITED, wait for Retry-After before querying again.
• Stop polling after a terminal status.

Possible errors include 400 INVALID_REQUEST, 401 AUTH_REQUIRED, 401 AUTH_INVALID, 401 AUTH_EXPIRED, 403 AUTH_SCOPE_DENIED, 404 COMMAND_NOT_FOUND, 429 RATE_LIMITED, and 500 INTERNAL_ERROR.