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",
    "accountId": "5bfafad0-5194-49eb-99b6-f827c53e2bbd",
    "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
    },
    "location": {
        "source": "Cellular",
        "latitude": 55.83749771,
        "longitude": 12.54119396,
        "accuracy": 180.0
    }
}

Temperature Alert with Consecutive Deviation

{
    "id": "9557cd83-aa04-4194-a628-0d2b1b8d05b2",
    "ruleId": "76511e3f-96dc-434b-84a5-33695dd45c21",
    "accountId": "5bfafad0-5194-49eb-99b6-f827c53e2bbd",
    "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
    }
}

Temperature Alert with Cumulative Deviation

{
    "id": "9557cd83-aa04-4194-a628-0d2b1b8d05b2",
    "ruleId": "76511e3f-96dc-434b-84a5-33695dd45c21",
    "accountId": "5bfafad0-5194-49eb-99b6-f827c53e2bbd",
    "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
    }
}

Humidity Alert

{
    "id": "9557cd83-aa04-4194-a628-0d2b1b8d05b2",
    "ruleId": "76511e3f-96dc-434b-84a5-33695dd45c21",
    "accountId": "5bfafad0-5194-49eb-99b6-f827c53e2bbd",
    "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
    },
    "location": {
        "source": "Cellular",
        "latitude": 55.83749771,
        "longitude": 12.54119396,
        "accuracy": 180.0
    }
}

Shock Alert

{
    "id": "9557cd83-aa04-4194-a628-0d2b1b8d05b2",
    "ruleId": "76511e3f-96dc-434b-84a5-33695dd45c21",
    "accountId": "5bfafad0-5194-49eb-99b6-f827c53e2bbd",
    "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
    },
    "location": {
        "source": "Cellular",
        "latitude": 55.83749771,
        "longitude": 12.54119396,
        "accuracy": 180.0
    }
}

Security Alert – Parcel Opened before it reaches its destination

{
    "id": "9557cd83-aa04-4194-a628-0d2b1b8d05b2",
    "ruleId": "76511e3f-96dc-434b-84a5-33695dd45c21",
    "accountId": "5bfafad0-5194-49eb-99b6-f827c53e2bbd",
    "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"
    },
    "location": {
        "source": "Cellular",
        "latitude": 55.83749771,
        "longitude": 12.54119396,
        "accuracy": 180.0
    }
}

Security Alert – Unauthorized Location

{
    "id": "9557cd83-aa04-4194-a628-0d2b1b8d05b2",
    "ruleId": "76511e3f-96dc-434b-84a5-33695dd45c21",
    "accountId": "5bfafad0-5194-49eb-99b6-f827c53e2bbd",
    "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"
    },
    "location": {
        "source": "Cellular",
        "latitude": 55.83749771,
        "longitude": 12.54119396,
        "accuracy": 180.0
    }
}

Security Alert – Light Exposure Before Arrival

{
    "id": "9557cd83-aa04-4194-a628-0d2b1b8d05b2",
    "ruleId": "76511e3f-96dc-434b-84a5-33695dd45c21",
    "accountId": "5bfafad0-5194-49eb-99b6-f827c53e2bbd",
    "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"
    },
    "location": {
        "source": "GPS",
        "latitude": 55.83749771,
        "longitude": 12.54119396,
        "accuracy": 100.0
    }
}

Lifecycle Alert – Arrival at Destination

{
    "id": "9557cd83-aa04-4194-a628-0d2b1b8d05b2",
    "ruleId": "76511e3f-96dc-434b-84a5-33695dd45c21",
    "accountId": "5bfafad0-5194-49eb-99b6-f827c53e2bbd",
    "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"
    },
    "location": {
        "source": "Cellular",
        "latitude": 55.83749771,
        "longitude": 12.54119396,
        "accuracy": 180.0
    }
}

Lifecycle Alert – Departure from Origin

{
    "id": "9557cd83-aa04-4194-a628-0d2b1b8d05b2",
    "ruleId": "76511e3f-96dc-434b-84a5-33695dd45c21",
    "accountId": "5bfafad0-5194-49eb-99b6-f827c53e2bbd",
    "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"
    },
    "location": {
        "source": "Cellular",
        "latitude": 55.83749771,
        "longitude": 12.54119396,
        "accuracy": 180.0
    }
}

Lifecycle Alert – Landing

{
    "id": "9557cd83-aa04-4194-a628-0d2b1b8d05b2",
    "ruleId": "76511e3f-96dc-434b-84a5-33695dd45c21",
    "accountId": "5bfafad0-5194-49eb-99b6-f827c53e2bbd",
    "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"
    },
    "location": {
        "source": "GPS",
        "latitude": 55.83749771,
        "longitude": 12.54119396,
        "accuracy": 80.0
    }
}

Lifecycle Alert – Package Opened After Arrival

{
    "id": "9557cd83-aa04-4194-a628-0d2b1b8d05b2",
    "ruleId": "76511e3f-96dc-434b-84a5-33695dd45c21",
    "accountId": "5bfafad0-5194-49eb-99b6-f827c53e2bbd",
    "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"
    },
    "location": {
        "source": "Cellular",
        "latitude": 55.83749771,
        "longitude": 12.54119396,
        "accuracy": 180.0
    }
}

Lifecycle Alert – Light Exposure After Arrival

{
    "id": "9557cd83-aa04-4194-a628-0d2b1b8d05b2",
    "ruleId": "76511e3f-96dc-434b-84a5-33695dd45c21",
    "accountId": "5bfafad0-5194-49eb-99b6-f827c53e2bbd",
    "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"
    },
    "location": {
        "source": "Cellular",
        "latitude": 55.83749771,
        "longitude": 12.54119396,
        "accuracy": 180.0
    }
}

Delivery Assurance Alert – Dwell

{
  "id": "9557cd83-aa04-4194-a628-0d2b1b8d05b2",
  "ruleId": "76511e3f-96dc-434b-84a5-33695dd45c21",
  "accountId": "5bfafad0-5194-49eb-99b6-f827c53e2bbd",
  "scope": {
    "type": "Shipment",
    "id": "357aebc5-692d-4b25-87d0-fc9ee7b3ada9"
  },
  "conditionType": "Dwell",
  "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",
    "totalDwellTime": 88313,
    "dwellThresholdTime": 86400
  },
  "location": {
     "source": "Cellular",
     "latitude": 55.83749771,
     "longitude": 12.54119396,
     "accuracy": 180.0
  }
}

Delivery Assurance Alert – FalsePickup

{
  "id": "9557cd83-aa04-4194-a628-0d2b1b8d05b2",
  "ruleId": "76511e3f-96dc-434b-84a5-33695dd45c21",
  "accountId": "5bfafad0-5194-49eb-99b6-f827c53e2bbd",
  "scope": {
    "type": "Shipment",
    "id": "357aebc5-692d-4b25-87d0-fc9ee7b3ada9"
  },
  "conditionType": "FalsePickup",
  "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",
    "carrierEventTime": "2025-04-19T04:40:00Z"
  }
}

Delivery Assurance Alert – FalseOutForDelivery

{
  "id": "9557cd83-aa04-4194-a628-0d2b1b8d05b2",
  "ruleId": "76511e3f-96dc-434b-84a5-33695dd45c21",
  "accountId": "5bfafad0-5194-49eb-99b6-f827c53e2bbd",
  "scope": {
    "type": "Shipment",
    "id": "357aebc5-692d-4b25-87d0-fc9ee7b3ada9"
  },
  "conditionType": "FalseOutForDelivery",
  "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",
    "carrierEventTime": "2025-04-19T04:40:00Z"
  }
}

Delivery Assurance Alert – FalseDelivery

{
  "id": "9557cd83-aa04-4194-a628-0d2b1b8d05b2",
  "ruleId": "76511e3f-96dc-434b-84a5-33695dd45c21",
  "accountId": "5bfafad0-5194-49eb-99b6-f827c53e2bbd",
  "scope": {
    "type": "Shipment",
    "id": "357aebc5-692d-4b25-87d0-fc9ee7b3ada9"
  },
  "conditionType": "FalseDelivery",
  "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",
    "carrierEventTime": "2025-04-19T04:40:00Z"
  }
}

Delivery Assurance Alert – MissedDeliveryTime

{
  "id": "9557cd83-aa04-4194-a628-0d2b1b8d05b2",
  "ruleId": "76511e3f-96dc-434b-84a5-33695dd45c21",
  "accountId": "5bfafad0-5194-49eb-99b6-f827c53e2bbd",
  "scope": {
    "type": "Shipment",
    "id": "357aebc5-692d-4b25-87d0-fc9ee7b3ada9"
  },
  "conditionType": "MissedDeliveryTime",
  "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",
    "requiredDeliveryTime": "2025-04-19T04:30:00Z"
  }
}

Delivery Assurance Alert – CarrierException

{
  "id": "9557cd83-aa04-4194-a628-0d2b1b8d05b2",
  "ruleId": "76511e3f-96dc-434b-84a5-33695dd45c21",
  "accountId": "5bfafad0-5194-49eb-99b6-f827c53e2bbd",
  "scope": {
    "type": "Shipment",
    "id": "357aebc5-692d-4b25-87d0-fc9ee7b3ada9"
  },
  "conditionType": "CarrierException",
  "severity": "Error",
  "firedTime": "2025-04-19T05:01:47.3636325Z",
  "timestamp": "2025-04-19T04:56:51.1456072Z",
  "properties": {
    "timestamp": "2025-04-19T04:56:51.1456072Z",
    "localTimestamp": "2025-04-19T05:56:51",
    "location": "Berlin, DE",
    "eventDescription": "Shipment delayed due to operational disruption."
  }
}

Delivery Assurance Alert – MissedFlight

{
  "id": "9557cd83-aa04-4194-a628-0d2b1b8d05b2",
  "ruleId": "76511e3f-96dc-434b-84a5-33695dd45c21",
  "accountId": "5bfafad0-5194-49eb-99b6-f827c53e2bbd",
  "scope": {
    "type": "Shipment",
    "id": "357aebc5-692d-4b25-87d0-fc9ee7b3ada9"
  },
  "conditionType": "MissedFlight",
  "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",
    "flightNumber": "LH123",
    "departureTime": "2025-04-19T04:30:00Z"
  }
}

Delivery Assurance Alert – FlightConnectionRisk

{
  "id": "9557cd83-aa04-4194-a628-0d2b1b8d05b2",
  "ruleId": "76511e3f-96dc-434b-84a5-33695dd45c21",
  "accountId": "5bfafad0-5194-49eb-99b6-f827c53e2bbd",
  "scope": {
    "type": "Shipment",
    "id": "357aebc5-692d-4b25-87d0-fc9ee7b3ada9"
  },
  "conditionType": "FlightConnectionRisk",
  "severity": "Error",
  "firedTime": "2025-04-19T05:01:47.3636325Z",
  "timestamp": "2025-04-19T04:56:51.1456072Z",
  "properties": {
    "flightNumber": "LH456",
    "connectionTime": 20
  }
}