POST getHistory
https://m360soft.com/api/customer/v2/getHistory
Lists the previously uploaded and closed device session records (work history)
Request parameters
| Name | Type | Description |
|---|---|---|
order |
string | The type and direction of the order of the records. Optional, possible values: ["id:desc", "id:asc", "connectionTime:desc", "connectionTime:asc"]. |
limit |
integer | Maximum number of returned records. Default: 20. Optional, range: 1 - 100. |
startingAfter |
string | Can be used for forward pagination. The ID of the last record on the previous page. Optional, exactly 36 characters. |
endingBefore |
string | Can be used for backward pagination. The ID of the first record on the next page. Optional, exactly 36 characters. |
sessionId |
string | Filters the results by session ID. Optional, exactly 36 characters. |
imei |
array | Filters the results by IMEI. Maximum 10 values can be provided as an array or a single value as a string. Optional, 1 - 10 elements, The values should be string, minimum 3 and maximum 20 characters matching with this format: "/^[0-9a-fA-F-]{3,20}$/". |
serial |
array | Filters the results by device serial. Maximum 10 values can be provided as an array or a single value as a string. Optional, 1 - 10 elements, The values should be string, minimum 3 and maximum 64 characters matching with this format: "/^[a-zA-Z0-9]{3,64}$/". |
m360id |
array | Filters the results by M360 ID. Maximum 10 values can be provided as an array or a single value as a string. Optional, 1 - 10 elements, The values should be string, minimum 3 and maximum 20 characters matching with this format: "/^[a-zA-Z0-9]{3,20}$/". |
customId |
array | Filters the results by Custom ID. Maximum 10 values can be provided as an array or a single value as a string. Optional, 1 - 10 elements, The values should be string, minimum 3 and maximum 50 characters. |
friendlyName |
string | Filters the results by friendly name. Optional, 3 - 100 characters. |
username |
string | Filters the results by username. Optional, 3 - 100 characters. |
connectionTimeMin |
string | Filters the results by minimum connection time. If you did not provide a time zone in the value, the server will use the one you have specified in the timeZone parameter. Optional, Any valid datetime value. |
connectionTimeMax |
string | Filters the results by maximum connection time. If you did not provide a time zone in the value, the server will use the one you have specified in the timeZone parameter. Optional, Any valid datetime value. |
hasDiagnostics |
bool | Setting this filter option to TRUE or FALSE will filter out all records without or with diagnostics results respectively. Optional. |
hasGrading |
bool | Setting this filter option to TRUE or FALSE will filter out all records without or with grading results respectively. Optional. |
hasWipe |
bool | Setting this filter option to TRUE or FALSE will filter out all records without or with wipe results respectively. Optional. |
hasOemCheck |
bool | Setting this filter option to TRUE or FALSE will filter out all records without or with OEM check results respectively. Optional. |
hasBlacklistCheck |
bool | Setting this filter option to TRUE or FALSE will filter out all records without or with blacklist checks respectively. Optional. |
hasSimLockCheck |
bool | Setting this filter option to TRUE or FALSE will filter out all records without or with SIM lock checks respectively. Optional. |
hasReport |
bool | Setting this filter option to TRUE or FALSE will filter out all records without or with generated reports respectively. Optional. |
isManual |
bool | Setting this filter option to TRUE or FALSE will filter out all non-manual or manual records respectively. Optional. |
includeOpen |
bool | Setting this filter option to TRUE will include sessions that are still open. Note that open sessions will appear in the history only after the device has been identified successfully. Optional. |
onlyOpen |
bool | Setting this filter option to TRUE will include only open sessions. Optional. |
isActive |
bool | Setting this filter option to TRUE will include only active sessions (open and connected). Settings this filter to FALSE will include only inactive (closed or disconnected) sessions. Optional. |
calculateTotalCount |
bool | Setting this to TRUE will calculate the total number of records that match the filters up to 10000. The response will contain the total count in the totalCount field. If the number of matching records is greater than 10000, the totalCount field will contain the value 10000. Optional. |
timeZone |
string | The time zone to use when displaying dates and times. Optional, max. 100 characters, Any valid timezone value, a time zone name (e.g. "Europe/Budapest"), not a UTC offset. |
testing |
bool | Setting this value to true will result in a response populated only with syntactically correct test data which can be used to test the API integration. While your account is in testing mode the value of this parameter is always true and cannot be overridden. Optional. |
Response
Thedata of the response is a
GetHistoryResponseData
object
This is the data object of the response of the getHistory API endpoint.
Examples
200
OK
POST https://m360soft.com/api/customer/v2/getHistory
Request
POST https://m360soft.com/api/customer/v2/getHistoryContent-Type: application/json{ "imei": [ "990000862471854", "990000862471855" ], "calculateTotalCount": true }
Response application/json
{
"data": {
"records": [
{
"sessionId": "1a3be5f5-dedd-470e-8252-0468b5216ace",
"username": null,
"createdAt": "2025-01-01T12:00:00+00:00",
"connectionTime": "2025-01-01T12:00:00+00:00",
"marketingName": null,
"friendlyName": "M360test TestPhone 9T 64 GB",
"alternativeFriendlyNames": [],
"modelName": null,
"applicationVersion": null,
"m360id": "AS4MPL3S4MPL3S4MPL3S",
"imei": "990000862471854",
"imei2": "351756051523999",
"isManual": true,
"isActive": false,
"isClosed": true,
"isCombined": false,
"batteryHealthPercent": "95%",
"preciseBatteryHealthPercent": "95%",
"estimatedBatteryHealthPercent": null,
"batteryHealthDiagnosticsResult": null,
"batteryFirstUseDate": [
"20260101",
"20260101"
],
"batteryManufacturingDate": [
"20251201",
"20251202"
],
"associatedAccount": null,
"brandAccounts": null,
"samsungKnoxWarranty": "valid",
"deviceOrigin": null,
"simStatus": "has_sim",
"networkOperator": "vodafone HU",
"simLock": null,
"soc": "Qualcomm Snapdragon 1234",
"basebandVersion": null,
"bluetoothMac": "38:DF:40:88:A8:74",
"wifiMac": "3F:79:DE:BF:2D:30",
"portName": "1",
"osType": "android",
"softwareVersion": "7.0",
"mobilAppVersion": null,
"modelCode": "SAMPLE",
"extendedModelCode": null,
"fullModelCode": null,
"manufacturer": "SAMPLE",
"brand": "TestPhone",
"productCode": "SAMPLE",
"serial": "SAMPLE",
"eid": "12345678901234567890123456789012",
"udid": null,
"ecid": null,
"internalStorage": null,
"internalStorageFree": "60 GB",
"totalRAMSize": "8 GB",
"iosSalesRegion": null,
"MDMState": null,
"batteryCycles": null,
"batteryDesignCapacity": null,
"fullChargeCapacity": null,
"rooted": false,
"secureLocked": null,
"memoryCard": null,
"iosRegulatoryModel": null,
"regulatoryNumber": null,
"deviceColor": null,
"iosJailbreak": null,
"encryptionState": null,
"encryptionType": null,
"iosDesignatedRegion": null,
"frpState": null,
"logicalDisplayCount": null,
"device": {
"createdAt": "2025-01-01T12:00:00+00:00",
"m360id": "AS4MPL3S4MPL3S4MPL3S",
"actualBlacklistCheckResult": {
"createdAt": "2025-01-01T12:00:00+00:00",
"imei": "990000862471854",
"result": "red"
},
"actualSimLockCheckResult": {
"createdAt": "2025-01-01T12:00:00+00:00",
"imei": "990000862471854",
"carrier": "Unlocked",
"isLocked": "",
"purchaseCountry": null
},
"actualStickyData": {
"createdAt": "2025-01-01T12:00:00+00:00",
"customId": "phone-001",
"phoneStatus": "unknown",
"overallRating": "N/A",
"notes": "",
"client": null
},
"actualGradingResult": null,
"actualGradingPhotos": [],
"actualDeviceExpense": null
},
"physicalSimPresence": null,
"eSimPresence": null,
"simTrayPresence": null,
"eSimCapable": null,
"iccid": null,
"iccid2": null,
"simSlot1Carrier": null,
"simSlot2Carrier": null,
"simSlot1IsEsim": null,
"simSlot2IsEsim": null,
"watchCaseMaterial": null,
"watchCaseSize": null,
"watchCollection": null,
"watchConnection": null,
"diagnosticsReports": [
{
"createdAt": "2025-01-01T12:00:00+00:00",
"locale": "en",
"htmlLink": "https://m360soft.com/reports/diagnostics/sample.html",
"pdfLink": "https://m360soft.com/reports/diagnostics/sample.pdf"
}
],
"diagnosticsResults": [],
"oemCheckResult": null,
"gradingResult": null,
"stickyData": null,
"deviceExpense": null,
"wipeResult": {
"createdAt": "2025-01-01T12:00:00+00:00",
"clientTime": "2025-01-01T12:00:00+00:00",
"type": "secure",
"result": "finished",
"hasWarning": false
},
"flashResult": {
"createdAt": "2025-01-01T12:00:00+00:00",
"clientTime": "2025-01-01T12:00:00+00:00",
"type": "Data Wipe",
"result": "Finished",
"startingVersion": "1.0.0",
"targetVersion": "2.0.0",
"buildId": "ABC123"
},
"gradingPhotos": [],
"blacklistCheckResult": {
"createdAt": "2025-01-01T12:00:00+00:00",
"imei": "990000862471854",
"result": "green"
},
"simLockCheckResult": {
"createdAt": "2025-01-01T12:00:00+00:00",
"imei": "990000862471854",
"carrier": "Unlocked",
"isLocked": "",
"purchaseCountry": null
}
}
],
"hasMore": false,
"totalCount": 1
},
"meta": {
"success": true
}
}
400
Bad Request
POST https://m360soft.com/api/customer/v2/getHistory
Request
POST https://m360soft.com/api/customer/v2/getHistoryContent-Type: application/json{ "limit": -1 }
Response application/json
{
"data": [],
"meta": {
"success": false,
"errors": {
"code": "validation:parameter_error",
"title": "One or more parameters are missing or invalid",
"details": {
"limit": [
"This value should be between 1 and 100."
]
}
}
}
}