GET
/
api
/
v1
/
open
/
device-requests
/
{request_id}
Get a device request
curl --request GET \
  --url https://api.example.com/api/v1/open/device-requests/{request_id} \
  --header 'X-Api-Id: <x-api-id>' \
  --header 'X-Api-Nonce: <x-api-nonce>' \
  --header 'X-Api-Signature: <api-key>' \
  --header 'X-Api-Timestamp: <x-api-timestamp>'
{
  "request_id": "devreq-001",
  "vendor": "dji",
  "device_id": "dock-001",
  "request_type": "config",
  "inbound_payload": {
    "scope": "dock"
  },
  "routing_decision": "CALLER_REPLY_REQUIRED",
  "reply_code": "PENDING",
  "reply_message": "waiting for reply",
  "reply_source": "OPEN_PLATFORM",
  "standardized_reply": {},
  "received_at": "2026-04-22T12:00:00Z",
  "replied_at": null,
  "updated_at": "2026-04-22T12:00:00Z"
}

Authorizations

​
X-Api-Signature
string
header
required

HMAC signature; X-Api-Id, X-Api-Timestamp, and X-Api-Nonce are also required.

Headers

​
X-Api-Id
string
required

API credential ID.

​
X-Api-Timestamp
string
required

Unix timestamp in seconds.

​
X-Api-Nonce
string
required

Replay-protection nonce.

​
X-Api-Signature
string
required

HMAC request signature.

​
X-Request-Id
string

Optional correlation ID.

Path Parameters

​
request_id
string
required

Device request ID

Response

Device request detail.

​
request_id
string
required
​
vendor
string
required
Example:

"dji"

​
device_id
string
required
​
request_type
string
required
Example:

"config"

​
routing_decision
string
required
​
reply_code
string
required
​
reply_message
string
required
​
reply_source
string
required
​
received_at
string<date-time>
required
​
updated_at
string<date-time>
required
​
inbound_payload
object
​
reply_requested_by
string
​
standardized_reply
object
​
replied_at
string<date-time> | null