Get Device
GET/api/v1/devices/:device
Get a Device
by its ID
.
Request
Path Parameters
Possible values: > 0
ID
of the Device
Responses
- 200
- 400
- 401
- 404
Success
- application/json
- Schema
- Example (from schema)
Schema
ID
of the Device
Possible values: > 0
1000
Name
of the Device
Device 1
Creation Date
of the Device
2025-03-12T18:12:44.465Z
Update Date
of the Device
2025-03-12T18:12:44.465Z
Type
of the Device
Possible values: [EdatecEDIPC2630
, WagoPFC300
, WagoPFC200
, WagoPFC100
, WagoCC100
, PLCNextAXCF2152
, WagoEdgeIPC
, SiemensIPC127
, WeidmullerUC20SL2000EC
, WeidmullerUV20BIPC10xx
, RUT300
, HD67644A1
, Flex
, Virtual
, VirtualMachineDebian12
, VirtualAwsEC2Ubuntu
, WestermoL210
, Generic
]
WagoEdgeIPC
Is the Device
onboarded
true
MAC addresses for this Device
Possible values: Value must match regular expression ^([0-9a-f]{2}:){5}([0-9a-f]{2})$
["11:22:33:44:55:66","77:88:99:AA:BB:CC"]
netbird
object
Netbird information for this Device
IP address
Domain name of the Device
device-name.netbird.cloud
workspace
object
ID
of the Workspace
Possible values: > 0
1000
Name
of the Workspace
Workspace 1
asset
object
ID
of the Asset
Possible values: > 0
1000
Name
of the Asset
Asset 1
division
object
ID
of the Division
Possible values: > 0
1000
Name
of the Division
Division 1
{
"id": 1000,
"name": "Device 1",
"createdAt": "2025-03-12T18:12:44.465Z",
"updatedAt": "2025-03-12T18:12:44.465Z",
"type": "WagoEdgeIPC",
"onboarded": true,
"macAddresses": [
"11:22:33:44:55:66",
"77:88:99:AA:BB:CC"
],
"netbird": {
"ip": "string",
"domain": "device-name.netbird.cloud"
},
"workspace": {
"id": 1000,
"name": "Workspace 1"
},
"asset": {
"id": 1000,
"name": "Asset 1"
},
"division": {
"id": 1000,
"name": "Division 1"
}
}
Validation Error
- application/json
- Schema
- Example (from schema)
Schema
Array [
]
Possible values: [Validation Error
]
errors
object[]
required
Possible values: [body
, query
, path
, headers
]
{
"status": "Validation Error",
"errors": [
{
"error": "string",
"location": "body"
}
]
}
Unauthorized
- application/json
- Schema
- Example (from schema)
Schema
Possible values: [Unauthorized
]
{
"status": "Unauthorized"
}
Device not found
- application/json
- Schema
- Example (from schema)
Schema
Possible values: [Device not found
]
{
"status": "Device not found"
}