Skip to Content
Documentation
API Documentation
Our API documentation and how to authorize towards Mammotion Open APIs.
API illustration

Push Message Reference

This document defines all SSE push message payloads. Each message is identified by the combination of pushTag + pushType.

Message Index Table

pushTagpushTypeDescriptionSubscription Property Key
attribute1Device main statusDEV_ST
attribute2Charge statusCHG_ST
attribute3Self-check statusSELF_CHK
attribute6Battery percentageBAT_PCT
attribute8Real-time coordinate positionCOORD
attribute9Network statusNET_ST
attribute10Work progressWK_PRG
notify1Device nickname modification eventDEV_INF
notify3New device binding eventENR_BIND
notify4Device unbinding eventENR_UNBIND
progress1OTA upgrade progressOTA_PRG
sc1Server kick-off system messageSystem internal

pushTag = attribute / pushType = 1: Device main status

Example:

{ "pushTag": "attribute", "pushType": 1, "pushData": { "deviceId": "OlHl7Hmm6DCsdZq8P5Ap000000", "deviceName": "Luba-VA925276", "status": 1, "mainStatus": "Standby", "lastOnlineTimestamp": 1763013324930, "createTimestamp": 1776058649790 } }

Field Description:

FieldTypeRequiredDescription
pushTagstringYesPush tag. Fixed value: attribute
pushTypeintYesPush type. Fixed value: 1
pushDataobjectYesBusiness payload of push message
pushData.deviceIdstringYesUnique device ID
pushData.deviceNamestringYesDevice name
pushData.statusintYesDevice status code
pushData.lastOnlineTimestamplongYesDevice last online time
pushData.createTimestamplongYesMessage create time

pushTag = attribute / pushType = 2: Charge status

Example:

{ "pushTag": "attribute", "pushType": 2, "pushData": { "deviceId": "OlHl7Hmm6DCsdZq8P5Ap000000", "deviceName": "Luba-VA925276", "chargeStatus": 0, "createTimestamp": 1776059243121 } }

Field Description:

FieldTypeRequiredDescription
pushTagstringYesPush tag. Fixed value: attribute
pushTypeintYesPush type. Fixed value: 2
pushDataobjectYesBusiness payload of push message
pushData.deviceIdstringYesUnique device ID
pushData.deviceNamestringYesDevice name
pushData.chargeStatusintYesCharge status
pushData.createTimestamplongYesMessage create time

pushTag = attribute / pushType = 3: Self-check status

Example:

{ "pushTag": "attribute", "pushType": 3, "pushData": { "deviceId": "OlHl7Hmm6DCsdZq8P5Ap000000", "deviceName": "Luba-VA987654", "selfCheckStatus": 11, "createTimestamp": 1776061196023 } }

Field Description:

FieldTypeRequiredDescription
pushTagstringYesPush tag. Fixed value: attribute
pushTypeintYesPush type. Fixed value: 3
pushDataobjectYesBusiness payload of push message
pushData.deviceIdstringYesUnique device ID
pushData.deviceNamestringYesDevice name
pushData.selfCheckStatusintYesSelf-check status code
pushData.createTimestamplongYesMessage create time

pushTag = attribute / pushType = 6: Battery percentage

Example:

{ "pushTag": "attribute", "pushType": 6, "pushData": { "deviceId": "OlHl7Hmm6DCsdZq8P5Ap000000", "deviceName": "Luba-VA987654", "batteryPercentage": 75, "createTimestamp": 1776061196023 } }

Field Description:

FieldTypeRequiredDescription
pushTagstringYesPush tag. Fixed value: attribute
pushTypeintYesPush type. Fixed value: 6
pushDataobjectYesBusiness payload of push message
pushData.deviceIdstringYesUnique device ID
pushData.deviceNamestringYesDevice name
pushData.batteryPercentageintYesBattery percentage (0~100)
pushData.createTimestamplongYesMessage create time

pushTag = attribute / pushType = 8: Real-time coordinate position

Example:

{ "pushTag": "attribute", "pushType": 8, "pushData": { "deviceId": "OlHl7Hmm6DCsdZq8P5Ap000000", "deviceName": "Luba-VA987654", "lon": 104.00894152, "lat": 30.46972243, "createTimestamp": 1776062984432 } }

Field Description:

FieldTypeRequiredDescription
pushTagstringYesPush tag. Fixed value: attribute
pushTypeintYesPush type. Fixed value: 8
pushDataobjectYesBusiness payload of push message
pushData.deviceIdstringYesUnique device ID
pushData.deviceNamestringYesDevice name
pushData.lonnumberYesLongitude
pushData.latnumberYesLatitude
pushData.createTimestamplongYesMessage create time

pushTag = attribute / pushType = 9: Network status

Example:

{ "pushTag": "attribute", "pushType": 9, "pushData": { "deviceId": "OlHl7Hmm6DCsdZq8P5Ap000000", "deviceName": "Luba-VA987654", "usedNet": "1", "wifiEnable": true, "wifiSignalGrid": 4, "fourGEnable": true, "fourGSignalGrid": 3, "createTimestamp": 1776065512320 } }

Field Description:

FieldTypeRequiredDescription
pushTagstringYesPush tag. Fixed value: attribute
pushTypeintYesPush type. Fixed value: 9
pushDataobjectYesBusiness payload of push message
pushData.deviceIdstringYesUnique device ID
pushData.deviceNamestringYesDevice name
pushData.usedNetstringYesCurrent network in use
pushData.wifiEnablebooleanYesWi-Fi enabled status
pushData.wifiSignalGridintYesWi-Fi signal level
pushData.fourGEnablebooleanYes4G enabled status
pushData.fourGSignalGridintYes4G signal level
pushData.createTimestamplongYesMessage create time

pushTag = attribute / pushType = 10: Work progress

Example:

{ "pushTag": "attribute", "pushType": 10, "pushData": { "deviceId": "OlHl7Hmm6DCsdZq8P5Ap000000", "deviceName": "Luba-VA987654", "workArea": 5074, "workProgress": 0, "elapsedTime": 2, "leftTime": 1179, "createTimestamp": 1776065937722 } }

Field Description:

FieldTypeRequiredDescription
pushTagstringYesPush tag. Fixed value: attribute
pushTypeintYesPush type. Fixed value: 10
pushDataobjectYesBusiness payload of push message
pushData.deviceIdstringYesUnique device ID
pushData.deviceNamestringYesDevice name
pushData.workAreaintYesWorking area
pushData.workProgressintYesWork progress
pushData.elapsedTimeintYesElapsed working time
pushData.leftTimeintYesRemaining work time
pushData.createTimestamplongYesMessage create time

pushTag = notify / pushType = 1: Device nickname modification event

Example:

{ "pushTag": "notify", "pushType": 1, "pushData": { "deviceId": "OlHl7Hmm6DCsdZq8P5Ap000000", "deviceName": "", "nickname": "" } }

Field Description:

FieldTypeRequiredDescription
pushTagstringYesPush tag. Fixed value: notify
pushTypeintYesPush type. Fixed value: 1
pushDataobjectYesBusiness payload of push message
pushData.deviceIdstringYesUnique device ID
pushData.deviceNamestringYesDevice name
pushData.nicknamestringYesNew nickname

pushTag = notify / pushType = 3: New device binding event

Example:

{ "pushTag": "notify", "pushType": 3, "pushData": { "deviceId": "4DM***d2p", "deviceName": "Luba-MB3PC6VL", "status": 19, "mainStatus": "TaskPaused", "lastOnlineTimestamp": 1793945914182, "usedNet": "1", "wifiEnable": true, "wifiSignalGrid": 3, "fourGEnable": false, "fourGSignalGrid": 3, "batteryPercentage": 62, "coordinate": { "lon": 104.0088707, "lat": 30.46998501 } } }

Field Description:

FieldTypeRequiredDescription
pushTagstringYesPush tag. Fixed value: notify
pushTypeintYesPush type. Fixed value: 3
pushDataobjectYesBusiness payload of push message
pushData.deviceIdstringYesUnique device ID
pushData.deviceNamestringYesDevice name
pushData.statusintYesStatus code
pushData.mainStatusstringYesMain status identifier
pushData.lastOnlineTimestamplongYesLast online timestamp (milliseconds)
pushData.usedNetstringYesCurrent network in use
pushData.wifiEnablebooleanYesWi-Fi enabled status
pushData.wifiSignalGridintYesWi-Fi signal level
pushData.fourGEnablebooleanYes4G enabled status
pushData.fourGSignalGridintYes4G signal level
pushData.batteryPercentageintYesBattery percentage (0~100)
pushData.coordinateobjectYesReal-time device coordinate position
pushData.coordinate.lonnumberYesLongitude
pushData.coordinate.latnumberYesLatitude

pushTag = notify / pushType = 4: Device unbinding event

Example:

{ "pushTag": "notify", "pushType": 4, "pushData": { "deviceId": "OlHl7Hmm6DCsdZq8P5Ap000000", "deviceName": "", "status": 1, "mainStatus": 1 } }

Field Description:

FieldTypeRequiredDescription
pushTagstringYesPush tag. Fixed value: notify
pushTypeintYesPush type. Fixed value: 4
pushDataobjectYesBusiness payload of push message
pushData.deviceIdstringYesUnique device ID
pushData.deviceNamestringYesDevice name
pushData.statusintYesUnbind status
pushData.mainStatusintYesDevice current status

pushTag = progress / pushType = 1: OTA upgrade progress

Example:

{ "pushTag": "progress", "pushType": 1, "pushData": { "deviceId": "OlHl7Hmm6DCsdZq8P5Ap000000", "deviceName": "Luba-VA653699", "oldVersion": "2.1.1.9004", "newVersion": "2.1.1.9002", "progress": 100, "upgradeStatus": "complete", "failReason": [], "otaId": "843140742607011840", "triggerWay": "2" } }

Field Description:

FieldTypeRequiredDescription
pushTagstringYesPush tag. Fixed value: progress
pushTypeintYesPush type. Fixed value: 1
pushDataobjectYesBusiness payload of push message
pushData.deviceIdstringYesUnique device ID
pushData.deviceNamestringYesDevice name
pushData.oldVersionstringYesOriginal firmware version
pushData.newVersionstringYesTarget firmware version
pushData.progressintYesOTA upgrade progress percentage
pushData.upgradeStatusstringYesUpgrade status
pushData.failReasonarrayYesList of failure reasons
pushData.otaIdstringYesUnique OTA task ID
pushData.triggerWaystringYesUpgrade trigger mode

pushTag = sc / pushType = 1: Server kick-off system message

Example:

{ "pushTag": "sc", "pushType": 1 }

Field Description:

FieldTypeRequiredDescription
pushTagstringYesPush tag. Fixed value: sc
pushTypeintYesPush type. Fixed value: 1

Special system message: The client must close the connection gracefully, do NOT auto-reconnect.


Appendix

  • All timestamps are Unix timestamps in milliseconds.
  • All messages are delivered as SSE raw JSON payloads, without extra data: wrapper parsing logic.
  • New pushTag / pushType values will be appended to this document.
Last updated on
Logo
Mammotion Developer
2026 @MAMMOTION Technology