Skip to main content

System alerts search

Request

This endpoint returns all system alerts in a paginated way allows narrowing returned results by submitting additional search filters.

Allowed search filters:

PropertyOperatorDescription
/status=, INAlert status, INACTIVE or ACTIVE
/assetTagUid=, INAsset tag point unique id, example: PA8A.CB-CRITICAL-DB2:tripped
/assetTagDisplayName=, INActive tag reading display value, example: ALARM
/configuration/thresholdType=, INExample: DIGITAL
/configuration/conditionName=, INName given to the alarm condition. Example: ALARM
/asset/ibx=, INName of the IBX for which data is being requested, example: PA8A
/asset/assetUid=, IN, LIKEAsset unique ID, example: PA8A.CB-CRITICAL-DB2:tripped#DIGITAL:ALARM
/activeProcessing/edgeCollectedOn=, >=, <=When tag reading was collected on source, example: 2022-09-23T13:40:53.449276Z
/asset/assetUnderMaintenance=, INAsset was under maintenance during alert processing, example: false
/asset/assetType=, INIndicates the template name for the asset, example: Circuit Breaker with Metering
/asset/assetClassification=, INThe class of assets this asset belongs to. Asset classification is electrical or mechanical, example: Electrical

Allowed search request sort options:

  • /status
  • /assetTagUid
  • /assetTagDisplayName
  • /configuration/thresholdType
  • /configuration/conditionName
  • /asset/ibx
  • /asset/assetUid
  • /activeProcessing/edgeCollectedOn
  • /asset/assetUnderMaintenance
  • /asset/assetType
  • /asset/assetClassification
Security
BearerAuth
Bodyapplication/jsonrequired
filterobject(SearchFilter)
paginationobject(SearchPagination)
sortArray of objects(SearchSort)

Array of sorting conditions.

Payload
{ "filter": { "and": [ … ] }, "pagination": { "offset": 0, "limit": 50 } }

Responses

OK

Bodyapplication/json
dataArray of objects(AlertReadModel)

Array of the alerts.

paginationobject(Pagination)

Represents pagination component of the paginated response

Response
{ "data": [ { … } ], "pagination": { "offset": 0, "limit": 0, "total": 0, "next": "string", "previous": "string" } }
Was this page helpful?