Get Signals

POST 
/api/v1/signals

Get multiple Signals from their IDs or Search JSON.

Request

application/json

Body

Body

signals

object

required

Array of Signal ID's or Search JSON's

oneOf

MOD1

Array of signal ID's

Array [

integer

Possible values: > 0

]

MOD2

Signal search JSON

Array [

workspace stringrequired

Name of the Workspace

Example: Workspace 1

asset stringrequired

Name of the Asset

Example: Asset 1

division stringrequired

Name of the Division

Example: Division 1

unit stringrequired

Name of the Unit

Example: Unit 1

signal stringrequired

Name of the Signal

Example: Signal 1

rename string

Name to give the returned signal. Defaults to the signal ID.

Possible values: <= 127 characters

]

Responses

200

Success

application/json

Schema

Schema

• Array [

id integerrequired
ID of the Signal
Possible values: > 0
Example: 1000
name stringrequired
Name of the Signal
Example: Signal 1
createdAt date-timerequired
Creation Date of the Signal
Example: 2025-08-25T19:29:40.667Z
updatedAt date-timerequired
Update Date of the Signal
Example: 2025-08-25T19:29:40.667Z
physicalUnit stringrequired
Physical unit of the Signal
Example: m/s
dataType stringrequired
Data type of the Signal
Possible values: [float, boolean, string, json]
Example: float
description stringnullablerequired
Description of the Signal
Example: Description
longDescription stringnullablerequired

Long description of the Signal

workspace

object

required

id integerrequired

ID of the Workspace

Possible values: > 0

Example: 1000

name stringrequired

Name of the Workspace

Example: Workspace 1

asset

object

required

id integerrequired

ID of the Asset

Possible values: > 0

Example: 1000

name stringrequired

Name of the Asset

Example: Asset 1

division

object

required

id integerrequired

ID of the Division

Possible values: > 0

Example: 1000

name stringrequired

Name of the Division

Example: Division 1

unit

object

required

id integerrequired

ID of the Unit

Possible values: > 0

Example: 1000

name stringrequired

Name of the Unit

Example: Unit 1

device

object

required

id integerrequired

ID of the Device

Possible values: > 0

Example: 1000

name stringrequired

Name of the Device

Example: Device 1

• ]

Example (from schema)

[
  {
    "id": 1000,
    "name": "Signal 1",
    "createdAt": "2025-08-25T19:29:40.667Z",
    "updatedAt": "2025-08-25T19:29:40.667Z",
    "physicalUnit": "m/s",
    "dataType": "float",
    "description": "Description",
    "longDescription": "string",
    "workspace": {
      "id": 1000,
      "name": "Workspace 1"
    },
    "asset": {
      "id": 1000,
      "name": "Asset 1"
    },
    "division": {
      "id": 1000,
      "name": "Division 1"
    },
    "unit": {
      "id": 1000,
      "name": "Unit 1"
    },
    "device": {
      "id": 1000,
      "name": "Device 1"
    }
  }
]

400

Validation Error

application/json

Schema

Schema

status stringrequired

Possible values: [Validation Error]

errors

object[]

required

Array [

error stringrequired

location stringrequired

Possible values: [body, query, path, headers]

]

Example (from schema)

{
  "status": "Validation Error",
  "errors": [
    {
      "error": "string",
      "location": "body"
    }
  ]
}

401

Unauthorized

application/json

Schema

Schema

status stringrequired

Possible values: [Unauthorized]

Example (from schema)

{
  "status": "Unauthorized"
}

404

Signal not found

application/json

Schema

Schema

status stringrequired

Possible values: [Signal not found]

signals

object

required

Not found signals

oneOf

MOD1

Array of signal ID's

Array [

integer

Possible values: > 0

]

MOD2

Signal search JSON

Array [

workspace stringrequired

Name of the Workspace

Example: Workspace 1

asset stringrequired

Name of the Asset

Example: Asset 1

division stringrequired

Name of the Division

Example: Division 1

unit stringrequired

Name of the Unit

Example: Unit 1

signal stringrequired

Name of the Signal

Example: Signal 1

rename string

Name to give the returned signal. Defaults to the signal ID.

Possible values: <= 127 characters

]

Example (from schema)

{
  "status": "Signal not found",
  "signals": [
    10000,
    10001,
    10002
  ]
}

Loading...