Alerts Common Schema

Sensos provides real-time delivery of alerts via webhooks. When specific conditions are met based on your shipment’s configuration and sensor data, an alert is triggered and a webhook is sent to your configured endpoint. This enables seamless integration with your own systems for tracking, automation, and response.

When an alert is triggered, a POST request is sent to your configured webhook URL with a JSON payload describing the event.

Temperature Alert

{
    "id": "9557cd83-aa04-4194-a628-0d2b1b8d05b2",
    "ruleId": "76511e3f-96dc-434b-84a5-33695dd45c21",
    "scope": {
        "type": "Shipment",
        "id": "357aebc5-692d-4b25-87d0-fc9ee7b3ada9"
    },
    "conditionType": "TemperatureBreach",
    "severity": "Error",
    "firedTime": "2025-04-19T05:01:47.3636325Z",
    "timestamp": "2025-04-19T04:56:51.1456072Z",
    "properties": {
       "reportId": "e5366302-965d-4318-9d7d-fcd6687a7e1c",
       "reportTime": "2025-04-19T04:56:51.1456072Z",
       "temperatureValue": 43,
       "minimumTemperatureThreshold": 20,
       "maximumTemperatureThreshold": 40,
       "allowedTemperatureTolerance": 0
    },
    "status": "New"
}

Temperature Alert with Consecutive Deviation

{
    "id": "9557cd83-aa04-4194-a628-0d2b1b8d05b2",
    "ruleId": "76511e3f-96dc-434b-84a5-33695dd45c21",
    "scope": {
        "type": "Shipment",
        "id": "357aebc5-692d-4b25-87d0-fc9ee7b3ada9"
    },
    "conditionType": "TemperatureBreach",
    "severity": "Error",
    "firedTime": "2025-04-19T05:01:47.3636325Z",
    "timestamp": "2025-04-19T04:56:51.1456072Z",
    "properties": {
       "reportId": "e5366302-965d-4318-9d7d-fcd6687a7e1c",
       "reportTime": "2025-04-19T04:56:51.1456072Z",
       "minimumTemperatureThreshold": 20,
       "maximumTemperatureThreshold": 40,
       "allowedTemperatureTolerance": 0,
       "consecutiveBreachThreshold": 600,
       "consecutiveBreachTime": 1800,
       "lastTemperatureInBreach": 42
    },
    "status": "New"
}

Temperature Alert with Cumulative Deviation

{
    "id": "9557cd83-aa04-4194-a628-0d2b1b8d05b2",
    "ruleId": "76511e3f-96dc-434b-84a5-33695dd45c21",
    "scope": {
        "type": "Shipment",
        "id": "357aebc5-692d-4b25-87d0-fc9ee7b3ada9"
    },
    "conditionType": "TemperatureBreachAccumulated",
    "severity": "Error",
    "firedTime": "2025-04-19T05:01:47.3636325Z",
    "timestamp": "2025-04-19T04:56:51.1456072Z",
    "properties": {
       "reportId": "e5366302-965d-4318-9d7d-fcd6687a7e1c",
       "reportTime": "2025-04-19T04:56:51.1456072Z",
       "minimumTemperatureThreshold": 20,
       "maximumTemperatureThreshold": 40,
       "allowedTemperatureTolerance": 0,
       "accumulatedBreachThreshold": 600,
       "accumulatedBreachTime": 1800,
       "lastTemperatureInBreach": 42
    },
    "status": "New"
}

Humidity Alert

{
    "id": "9557cd83-aa04-4194-a628-0d2b1b8d05b2",
    "ruleId": "76511e3f-96dc-434b-84a5-33695dd45c21",
    "scope": {
        "type": "Shipment",
        "id": "357aebc5-692d-4b25-87d0-fc9ee7b3ada9"
    },
    "conditionType": "HumidityBreach",
    "severity": "Error",
    "firedTime": "2025-04-19T05:01:47.3636325Z",
    "timestamp": "2025-04-19T04:56:51.1456072Z",
    "properties": {
       "reportId": "e5366302-965d-4318-9d7d-fcd6687a7e1c",
       "reportTime": "2025-04-19T04:56:51.1456072Z",
       "humidityValue": 82,
       "minimumHumidityThreshold": 20,
       "maximumHumidityThreshold": 70
    },
    "status": "New"
}

Shock Alert

{
    "id": "9557cd83-aa04-4194-a628-0d2b1b8d05b2",
    "ruleId": "76511e3f-96dc-434b-84a5-33695dd45c21",
    "scope": {
        "type": "Shipment",
        "id": "357aebc5-692d-4b25-87d0-fc9ee7b3ada9"
    },
    "conditionType": "ShockDetection",
    "severity": "Error",
    "firedTime": "2025-04-19T05:01:47.3636325Z",
    "timestamp": "2025-04-19T04:56:51.1456072Z",
    "properties": {
       "reportId": "e5366302-965d-4318-9d7d-fcd6687a7e1c",
       "reportTime": "2025-04-19T04:56:51.1456072Z",
       "shockMagnitude": 12000,
       "shockDuration": 30,
       "configuredShockThreshold": 10000,
       "configuredShockDurationThreshold": 20
    },
    "status": "New"
}

Security Alert – Parcel Opened before it reaches its destination

{
    "id": "9557cd83-aa04-4194-a628-0d2b1b8d05b2",
    "ruleId": "76511e3f-96dc-434b-84a5-33695dd45c21",
    "scope": {
        "type": "Shipment",
        "id": "357aebc5-692d-4b25-87d0-fc9ee7b3ada9"
    },
    "conditionType": "ParcelOpened",
    "severity": "Error",
    "firedTime": "2025-04-19T05:01:47.3636325Z",
    "timestamp": "2025-04-19T04:56:51.1456072Z",
    "properties": {
       "reportId": "e5366302-965d-4318-9d7d-fcd6687a7e1c",
       "reportTime": "2025-04-19T04:56:51.1456072Z",
       "parcelOpenedStage": "BeforeArrival"
    },
    "status": "New"
}

Security Alert – Unauthorized Location

{
    "id": "9557cd83-aa04-4194-a628-0d2b1b8d05b2",
    "ruleId": "76511e3f-96dc-434b-84a5-33695dd45c21",
    "scope": {
        "type": "Shipment",
        "id": "357aebc5-692d-4b25-87d0-fc9ee7b3ada9"
    },
    "conditionType": "UnauthorizedStop",
    "severity": "Error",
    "firedTime": "2025-04-19T05:01:47.3636325Z",
    "timestamp": "2025-04-19T04:56:51.1456072Z",
    "properties": {
       "reportId": "e5366302-965d-4318-9d7d-fcd6687a7e1c",
       "reportTime": "2025-04-19T04:56:51.1456072Z",
       "totalBreachTime": 7200,
       "breachThreshold": 3600,
       "metersToNearestPointOfInterest": 50000,
       "nearestPointOfInterestName": "My Warehouse"
    },
    "status": "New"
}

Security Alert – Light Exposure Before Arrival

{
    "id": "9557cd83-aa04-4194-a628-0d2b1b8d05b2",
    "ruleId": "76511e3f-96dc-434b-84a5-33695dd45c21",
    "scope": {
        "type": "Shipment",
        "id": "357aebc5-692d-4b25-87d0-fc9ee7b3ada9"
    },
    "conditionType": "LightBreach",
    "severity": "Error",
    "firedTime": "2025-04-19T05:01:47.3636325Z",
    "timestamp": "2025-04-19T04:56:51.1456072Z",
    "properties": {
       "reportId": "e5366302-965d-4318-9d7d-fcd6687a7e1c",
       "reportTime": "2025-04-19T04:56:51.1456072Z",
       "lightBreachStage": "BeforeArrival"
    },
    "status": "New"
}

Lifecycle Alert – Arrival at Destination

{
    "id": "9557cd83-aa04-4194-a628-0d2b1b8d05b2",
    "ruleId": "76511e3f-96dc-434b-84a5-33695dd45c21",
    "scope": {
        "type": "Shipment",
        "id": "357aebc5-692d-4b25-87d0-fc9ee7b3ada9"
    },
    "conditionType": "ShipmentArrival",
    "severity": "Error",
    "firedTime": "2025-04-19T05:01:47.3636325Z",
    "timestamp": "2025-04-19T04:56:51.1456072Z",
    "properties": {
       "reportId": "e5366302-965d-4318-9d7d-fcd6687a7e1c",
       "reportTime": "2025-04-19T04:56:51.1456072Z",
       "pointOfInterest": "Sensos Logistics Warehouse Canter, Berlin"
    },
    "status": "New"
}

Lifecycle Alert – Departure from Origin

{
    "id": "9557cd83-aa04-4194-a628-0d2b1b8d05b2",
    "ruleId": "76511e3f-96dc-434b-84a5-33695dd45c21",
    "scope": {
        "type": "Shipment",
        "id": "357aebc5-692d-4b25-87d0-fc9ee7b3ada9"
    },
    "conditionType": "ShipmentDeparture",
    "severity": "Error",
    "firedTime": "2025-04-19T05:01:47.3636325Z",
    "timestamp": "2025-04-19T04:56:51.1456072Z",
    "properties": {
       "reportId": "e5366302-965d-4318-9d7d-fcd6687a7e1c",
       "reportTime": "2025-04-19T04:56:51.1456072Z",
       "pointOfInterest": "Sensos Logistics Warehouse Canter, Berlin"
    },
    "status": "New"
}

Lifecycle Alert – Landing

{
    "id": "9557cd83-aa04-4194-a628-0d2b1b8d05b2",
    "ruleId": "76511e3f-96dc-434b-84a5-33695dd45c21",
    "scope": {
        "type": "Shipment",
        "id": "357aebc5-692d-4b25-87d0-fc9ee7b3ada9"
    },
    "conditionType": "Landing",
    "severity": "Warning",
    "firedTime": "2025-04-19T05:01:47.3636325Z",
    "timestamp": "2025-04-19T04:56:51.1456072Z",
    "properties": {
       "reportId": "e5366302-965d-4318-9d7d-fcd6687a7e1c",
       "reportTime": "2025-04-19T04:56:51.1456072Z"
    },
    "status": "New"
}

Lifecycle Alert – Package Opened After Arrival

{
    "id": "9557cd83-aa04-4194-a628-0d2b1b8d05b2",
    "ruleId": "76511e3f-96dc-434b-84a5-33695dd45c21",
    "scope": {
        "type": "Shipment",
        "id": "357aebc5-692d-4b25-87d0-fc9ee7b3ada9"
    },
    "conditionType": "ParcelOpened",
    "severity": "Error",
    "firedTime": "2025-04-19T05:01:47.3636325Z",
    "timestamp": "2025-04-19T04:56:51.1456072Z",
    "properties": {
       "reportId": "e5366302-965d-4318-9d7d-fcd6687a7e1c",
       "reportTime": "2025-04-19T04:56:51.1456072Z",
       "parcelOpenedStage": "AfterArrival"
    },
    "status": "New"
}

Lifecycle Alert – Light Exposure After Arrival

{
    "id": "9557cd83-aa04-4194-a628-0d2b1b8d05b2",
    "ruleId": "76511e3f-96dc-434b-84a5-33695dd45c21",
    "scope": {
        "type": "Shipment",
        "id": "357aebc5-692d-4b25-87d0-fc9ee7b3ada9"
    },
    "conditionType": "LightBreach",
    "severity": "Error",
    "firedTime": "2025-04-19T05:01:47.3636325Z",
    "timestamp": "2025-04-19T04:56:51.1456072Z",
    "properties": {
       "reportId": "e5366302-965d-4318-9d7d-fcd6687a7e1c",
       "reportTime": "2025-04-19T04:56:51.1456072Z",
       "lightBreachStage": "AfterArrival"
    },
    "status": "New"
}