Get Command Result

Returns the current execution status and final outcome of a command by command ID. The command ID is the data.id returned by the execute-device-operation response. The platform does not provide a command history list, so the caller should persist command IDs on its side.

Endpoint

GET /wlte/v1/commands/{commandId}

Authorization Requirements

Scope	Required	Description
device:read	Yes	Query command results

Request

Full URL:

GET {baseUrl}/wlte/v1/commands/{commandId}

Request headers:

Authorization: Bearer {accessToken}
Accept: application/json

Path parameters:

Parameter	Type	Required	Rule
commandId	string	Yes	The command ID returned in data.id

Success Response

HTTP status:

200 OK

Command Statuses

SENT
SUCCESS
FAILED
TIMEOUT

• SENT: the command is still waiting for final confirmation from the device
• SUCCESS: the device confirmed success
• FAILED: the command did not complete successfully
• TIMEOUT: the final outcome was not confirmed within the wait window

Response data Schema

Field	Type	Required	Description
id	string	Yes	Unique command identifier
deviceId	string	Yes	Device identifier
relayIndex	integer	Yes	Relay index, starting from 1
action	string	Yes	Command action. Enum: ON, OFF, JOG
status	string	Yes	Command status. Enum: SENT, SUCCESS, FAILED, TIMEOUT
createdAt	string	Yes	Command creation time in RFC3339 UTC

Polling Guidance

• If the initial command response returns SENT, poll this endpoint until a terminal status is returned
• Recommended polling interval: once every 2 to 3 seconds
• Recommended maximum polling duration: align it with the command wait window in your integration
• TIMEOUT means the command outcome was not confirmed in time. It does not prove that the device definitely did not act, so the client should decide whether to retry based on business rules and the current device state

Error Responses

Possible responses:

• 400 INVALID_REQUEST
• 401 AUTH_REQUIRED
• 401 AUTH_INVALID
• 401 AUTH_EXPIRED
• 403 AUTH_SCOPE_DENIED
• 404 COMMAND_NOT_FOUND
• 429 RATE_LIMITED
• 500 INTERNAL_ERROR