---
title: "Get single device action request"
method: GET
path: "/v1/integrate/devices/actions/requests/{requestId}"
tags: ["IoT Integrator"]
---

# Get single device action request

`GET /v1/integrate/devices/actions/requests/{requestId}`

## Request

- Base URL: `https://api.1nce.com/management-api`
- URL: `https://api.1nce.com/management-api/v1/integrate/devices/actions/requests/{requestId}`
- Auth: HTTP bearer

Get details about the device action request.

## Path parameters

- `requestId` string, required

## Response `200`

OK

- GetResponseschema1: Response to the request to get device action request.
  - `id` string, required: The ID of the request.
  - `status` 'SCHEDULED' | 'IN_PROGRESS' | 'FAILED' | 'SUCCEEDED' | 'CANCELLED', required: The status of the request.
  - `deviceId` string, required: The unique ID of the device.
  - `ip` string, required: The IP address of the device.
  - `protocol` string, required: The protocol of the request.
  - `created` string, date-time, required: The timestamp at which the request was created.
  - `updated` string, date-time, required: The timestamp at which the request was updated.
  - `mode` 'SEND_NOW' | 'SEND_WHEN_ACTIVE', required: The mode of the request.
  - `resultData` object: Result data (can include response from device etc.).
  - `requestData` object: Protocol specific request data.
  - `sendAttemptsLeft` number: How many attempts are left to send data to the device
  - `sendAttempts` number: The maximum number of attempts to send data to a device

## Other responses

- `403`: Forbidden
- `404`: Not Found Error
- `500`: Internal Server Error

---

[API](https://skmtc.dev/1nce/apis/1nce-os.md) - [All operations](https://skmtc.dev/1nce/apis/1nce-os/llms.txt) - [OpenAPI document](https://skmtc.dev/1nce/apis/1nce-os/revisions/f1aabbc6aeea?raw)
