M360 Customer API documentation

DeviceSession object

An object representing a device session. The device session stores all data that was collected while the device was connected to the desktop client.

Properties

PropertyTypeDescription
sessionId string The unique ID of the device session
username string | null The username of the user that has created the session. The value will be null if the user has been deleted
createdAt string | null The date and time when the data was saved on the server
connectionTime string | null The local time when the device was connected to the desktop client
marketingName string | null The marketing name of the device (iOS only). The marketing name is similar to the friendly name but does not contain extra information like the color or storage capacity of the device
friendlyName string | null The friendly name of the device
alternativeFriendlyNames array | null The alternative friendly names of the device (Android only)
modelName string | null The model name of the device
applicationVersion string | null The version of the desktop client that created the session
m360id string | null The globally unique M360 identifier of the device. In some rare instances the device can only be partially identified. In these cases this property will still be populated and you can use it to search for sessions but the device object will be empty, indicating that the full identification was failed.
imei string | null The IMEI number of the device.
imei2 string | null The second IMEI number of the device
isManual bool Indicates if the session was created manually
isActive bool | null Indicates if the session is currently active (the device is connected)
isClosed bool | null Indicates if session is closed (the device was disconnected and the session was closed)
isCombined bool Indicates if the session is combined
batteryHealthPercent string | null The health level of the battery as percentage (precise or estimated value)
preciseBatteryHealthPercent string | null The health level of the battery as percentage (precise value)
estimatedBatteryHealthPercent string | null The health level of the battery as percentage (estimated value)
batteryHealthDiagnosticsResult string | null The health level of the battery as percentage (drain test value)
batteryFirstUseDate array | null List of dates when the batteries were first used (yyyyMMdd)
batteryManufacturingDate array | null List of manufacturing dates of the batteries (yyyyMMdd)
associatedAccount string | null Presence of an associated account (Google, Samsung, AppleID etc.) on the device. Possible values:
ValueDescription
noNo account is present on the device
foundAn account is present on the device
brandAccounts array | null The list of brand accounts found on the device (Android only)
samsungKnoxWarranty string | null Status of the Samsung KNOX warranty. Possible values:
ValueDescription
validThe warranty is still valid
invalidThe warranty is void
unknownThe status of the warranty is unknown
deviceOrigin string | null Origin of the device. Possible values:
ValueDescription
retailThe device was sold by retail
refurbishedThe device was refurbished
replacementThe device is a replacement item
personalizedThe device is a personalized item
simStatus string | null Information about the presence of a SIM card. Possible values:
ValueDescription
no_simNo SIM card was found in the device
has_simA SIM card was found
networkOperator string | null The name of the network operator. This information is only available if a SIM card is present in the device
simLock string | null Indicates if the device is SIM locked (Samsung only, read directly from the device)
soc string | null The SoC (System on Chip) of the device
basebandVersion string | null The baseband (modem) firmware version of the device
bluetoothMac string | null The MAC address of the bluetooth network adapter if available
wifiMac string | null The MAC address of the Wi-Fi network adapter if available
portName string | null The name of the port the device was connected to
osType string | null The type of the operating system on the device. Possible values:
ValueDescription
androidAndroid
iosiOS
softwareVersion string | null The version of the operating system running on the device
mobilAppVersion string | null The version of the M360 application installed on the device
modelCode string | null The raw model code read from the device
extendedModelCode string | null The extended model code read from the device
fullModelCode string | null (Samsung only) The full model code of the device
manufacturer string | null The raw manufacturer name read from the device
brand string | null The brand name read from the device
productCode string | null The raw product code string read from the device
serial string | null The manufacturer specific serial number of the device
eid string | null The EID (Embedded Identity Document) number of the device
udid string | null The Unique Device Identifier of the device (iOS only)
ecid string | null The ECID of the device (iOS only)
internalStorage string | null The total internal storage space of the device
internalStorageFree string | null The free storage space on the internal storage of the device
totalRAMSize string | null The total RAM size installed on the device
iosSalesRegion string | null iOS sales region of the device
MDMState string | null The MDM state of the device
batteryCycles int | null The number of battery cycles
batteryDesignCapacity int | null The design capacity of the battery (mAh)
fullChargeCapacity int | null The full charge capacity of the battery (mAh)
rooted bool | null Indicates if the device is rooted
secureLocked bool | null Indicates if the device is secure locked
memoryCard bool | null Indicates if the device has a memory card
iosRegulatoryModel string | null The iOS regulatory model of the device. Deprecated, use regulatoryNumber instead, as it is supported by android devices too.
regulatoryNumber string | null The regulatory model number of the device (both iOS and android)
deviceColor string | null The color of the device
iosJailbreak bool | null Indicates if the device is jailbroken
encryptionState bool | null Indicates if the device storage is encrypted
encryptionType string | null The type of the device storage encryption. Possible values:
ValueDescription
fileFile-based encryption
diskFull disk encryption
iosDesignatedRegion string | null The associated region of the ios device
frpState bool | null Indicates the Factory Reset Protection state of the device (Android only)
logicalDisplayCount int | null Number of logical displays on the device
device Device | null An object representing the connected unique device and all of its data that is not session specific
physicalSimPresence string | null Indicates whether a physical SIM card is present in the device. Possible values:
ValueDescription
PresentA physical SIM card is present
NotPresentNo physical SIM card was found
NotCapableThe device does not support physical SIM cards
NAThe information is not available
eSimPresence string | null Indicates whether an eSIM profile is active on the device. Possible values:
ValueDescription
PresentAn eSIM profile is present
NotPresentNo eSIM profile was found
NotCapableThe device does not support eSIM
NAThe information is not available
simTrayPresence string | null Indicates whether the device's SIM card tray is present. Possible values:
ValueDescription
PresentThe SIM tray is present
NotPresentThe SIM tray is not present
NotCapableThe device does not have a SIM tray
NAThe information is not available
eSimCapable string | null Indicates whether the device hardware supports eSIM functionality. Possible values:
ValueDescription
PresentThe device is eSIM capable
NotPresentThe device is not eSIM capable
NotCapableThe device does not support eSIM
NAThe information is not available
iccid string | null The ICCID of the SIM card in the first slot (pairs with imei)
iccid2 string | null The ICCID of the SIM card in the second slot (pairs with imei2)
simSlot1Carrier string | null The carrier of the SIM card in the first slot
simSlot2Carrier string | null The carrier of the SIM card in the second slot
simSlot1IsEsim bool | null Indicates whether the SIM in the first slot is an embedded SIM (eSIM)
simSlot2IsEsim bool | null Indicates whether the SIM in the second slot is an embedded SIM (eSIM)
watchCaseMaterial string | null Apple Watch case material (e.g. Aluminum, Stainless Steel)
watchCaseSize string | null Apple Watch case size (e.g. 45mm)
watchCollection string | null Apple Watch collection (e.g. Regular, Nike, Hermès)
watchConnection string | null Apple Watch connectivity (e.g. gps, gpscell)
diagnosticsReports DiagnosticsReport[] Array of objects containing the diagnostics reports generated from the device session
diagnosticsResults DiagnosticsResult[] Array of objects containing the results of diagnostics tests performed during the session
oemCheckResult OemCheckResult | null An object containing the result of the OEM part check operation performed during the session
gradingResult GradingResult | null An object containing the last grading data of the device that was effective at the end of the device session
stickyData StickyData | null An object containing the last sticky information attached to the device that was effective at the end of the device session
deviceExpense DeviceExpense | null An object containing the last device expense data that was effective at the end of the device session
wipeResult WipeResult | null An object containing the result of the wipe operation performed during the session
flashResult FlashResult | null An object containing the result of the flash operation performed during the session
gradingPhotos GradingPhoto[] The list of the grading photos of the device available at the end of the session
blacklistCheckResult BlacklistCheckResult | null An object containing the last IMEI blacklist check result of the device that was effective at the end of the session
simLockCheckResult SimLockCheckResult | null An object containing the last SIM lock check result of the device that was effective at the end of the session

Used by