Get Device
GET
/api/v1/integrations/devices/{serial_number}DevicesReturns one device by serial_number for the account resolved from the Bearer token. If the account cannot be resolved or the device is not found for that account, the API responds with 404 (success: false, message text such as "Device not found").
Authentication
Bearer access token (Okta)Content-Type
application/jsonPath parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
serial_number | string | Yes | Device serial number. |
Headers
| Header | Required | Value |
|---|---|---|
Authorization | Yes | Bearer <access_token> |
Responses
| HTTP | Description |
|---|---|
| 200 | Device payload (`success`, `data`, `request_id`). |
| 401 | Unauthorized — invalid or missing Bearer token. |
| 404 | Device not found, or organization could not be resolved from the token. |
Response payload
Success response (200)
Response fields
| Field | Type | Description |
|---|---|---|
success | boolean | True when request succeeds. |
data | DeviceResponse | Device object for the provided serial number. |
data.network_interface | object | Interface status for `eth0`, `eth1`, and `lte`. |
request_id | string | Request correlation identifier. |
Example
Last updated on