M360 Customer API documentation

POST getExternalReports

https://m360soft.com/api/customer/v2/getExternalReports

Lists the incoming external reports

Request parameters

NameTypeDescription
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.
order string The type and direction of the order of the records. Optional, possible values: ["id:desc", "id:asc", "finishedTime:desc", "finishedTime: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, format: "/^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$/".
endingBefore string Can be used for backward pagination. The ID of the first record on the next page. Optional, exactly 36 characters, format: "/^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$/".
imei string Filters the results by IMEI / serial. Optional, 3 - 20 characters, format: "/^[0-9a-fA-F-]{3,20}$/".
friendlyName string Filters the results by friendly name. Optional, 3 - 100 characters.
email string Filters the results by sender email. Optional, 3 - 100 characters.
osType string Filters the results by operating system type. Optional, possible values: ["android", "ios"].
finishedTimeMin string Filters the results by finished time. Optional, Any valid datetime value.
finishedTimeMax string Filters the results by finished time. Optional, Any valid datetime value.
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.
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

The data of the response is a GetExternalReportsResponseData object This is the data object of the response of the getExternalReports API endpoint.

Examples

200 OK POST https://m360soft.com/api/customer/v2/getExternalReports
Request
POST https://m360soft.com/api/customer/v2/getExternalReportsContent-Type: application/json

{
    "limit": 10,
    "friendlyName": "iphone",
    "calculateTotalCount": true
}
Response application/json
{
    "data": {
        "records": [
            {
                "uid": "49f8faf8-1692-4a9c-af4f-7e86937962f8",
                "email": "[email protected]",
                "createdAt": "2025-01-01T12:00:00+00:00",
                "finishedTime": "2025-01-01T12:00:00+00:00",
                "friendlyName": "iPhone 13 128 GB",
                "imei": "352234567890123",
                "osType": "ios",
                "manufacturer": "Apple",
                "model": null,
                "identifier": "iPhone14,5",
                "storage": "128 GB",
                "appVersion": "3.1.4",
                "htmlLink": "https://m360soft.com/reports/app/sample.html",
                "tests": [
                    {
                        "testId": "TouchScreen",
                        "result": "Passed",
                        "elapsedTime": [],
                        "details": [
                            {
                                "context": "TouchTestVersion",
                                "title": "Version",
                                "result": "Passed",
                                "value": "Full-screen (more precise)"
                            }
                        ]
                    },
                    {
                        "testId": "Multitouch",
                        "result": "Passed",
                        "elapsedTime": [],
                        "details": [
                            {
                                "context": "MultitouchDetectedNumberOfTouches",
                                "title": "Number of touches",
                                "result": "Passed",
                                "value": "3"
                            }
                        ]
                    },
                    {
                        "testId": "Color",
                        "result": "Failed",
                        "elapsedTime": [],
                        "details": []
                    },
                    {
                        "testId": "Touch3D",
                        "result": "Failed",
                        "elapsedTime": [],
                        "details": []
                    },
                    {
                        "testId": "Speaker",
                        "result": "Passed",
                        "elapsedTime": [],
                        "details": [
                            {
                                "context": "SpeakerEar",
                                "title": "Ear Speaker",
                                "result": "Passed",
                                "value": "Auto"
                            },
                            {
                                "context": "SpeakerLoud",
                                "title": "Loud Speaker",
                                "result": "Passed",
                                "value": "Auto"
                            }
                        ]
                    },
                    {
                        "testId": "Microphone",
                        "result": "Failed",
                        "elapsedTime": [],
                        "details": [
                            {
                                "context": "MicrophoneBottom",
                                "title": "Bottom",
                                "result": "Failed",
                                "value": "Manual"
                            },
                            {
                                "context": "MicrophoneFront",
                                "title": "Front",
                                "result": "Passed",
                                "value": "Manual"
                            },
                            {
                                "context": "MicrophoneBack",
                                "title": "Back",
                                "result": "Skipped",
                                "value": "Manual"
                            }
                        ]
                    },
                    {
                        "testId": "Headphones",
                        "result": "Skipped",
                        "elapsedTime": [],
                        "details": []
                    },
                    {
                        "testId": "HardwareButton",
                        "result": "Passed",
                        "elapsedTime": [],
                        "details": [
                            {
                                "context": "HardwareButtonPower",
                                "title": "Power/Lock",
                                "result": "Passed",
                                "value": ""
                            },
                            {
                                "context": "HardwareButtonVolumeUp",
                                "title": "Volume Up",
                                "result": "Passed",
                                "value": ""
                            },
                            {
                                "context": "HardwareButtonVolumeDown",
                                "title": "Volume Down",
                                "result": "Passed",
                                "value": ""
                            },
                            {
                                "context": "HardwareButtonAction",
                                "title": "Action Button",
                                "result": "Passed",
                                "value": ""
                            }
                        ]
                    },
                    {
                        "testId": "Battery",
                        "result": "Passed",
                        "elapsedTime": [],
                        "details": [
                            {
                                "context": "PreciseBatteryHealth",
                                "title": "OEM Battery Health",
                                "result": "NA",
                                "value": "100%"
                            },
                            {
                                "context": "BatteryOriginalCapacity",
                                "title": "Original Capacity",
                                "result": "NA",
                                "value": "3181 mAh"
                            },
                            {
                                "context": "BatteryCurrentCapacity",
                                "title": "Current Capacity",
                                "result": "NA",
                                "value": "3181 mAh"
                            },
                            {
                                "context": "BatteryCycles",
                                "title": "Battery Cycles",
                                "result": "NA",
                                "value": "5"
                            }
                        ]
                    },
                    {
                        "testId": "RearCamera",
                        "result": "Skipped",
                        "elapsedTime": [],
                        "details": []
                    },
                    {
                        "testId": "FrontCamera",
                        "result": "Passed",
                        "elapsedTime": [],
                        "details": []
                    },
                    {
                        "testId": "Autofocus",
                        "result": "Passed",
                        "elapsedTime": [],
                        "details": []
                    },
                    {
                        "testId": "Flash",
                        "result": "Failed",
                        "elapsedTime": [],
                        "details": []
                    },
                    {
                        "testId": "Vibration",
                        "result": "Passed",
                        "elapsedTime": [],
                        "details": []
                    },
                    {
                        "testId": "Storage",
                        "result": "Passed",
                        "elapsedTime": [],
                        "details": [
                            {
                                "context": "StorageTotal",
                                "title": "Total",
                                "result": "NA",
                                "value": "127.9 GB"
                            },
                            {
                                "context": "StorageFree",
                                "title": "Free",
                                "result": "NA",
                                "value": "112.5 GB"
                            },
                            {
                                "context": "StorageUsed",
                                "title": "Used",
                                "result": "NA",
                                "value": "15.4 GB"
                            }
                        ]
                    },
                    {
                        "testId": "Pen",
                        "result": "Skipped",
                        "elapsedTime": [],
                        "details": []
                    },
                    {
                        "testId": "Accelerometer",
                        "result": "Passed",
                        "elapsedTime": [],
                        "details": []
                    },
                    {
                        "testId": "Gyroscope",
                        "result": "Passed",
                        "elapsedTime": [],
                        "details": []
                    },
                    {
                        "testId": "Proximity",
                        "result": "Skipped",
                        "elapsedTime": [],
                        "details": []
                    },
                    {
                        "testId": "Light",
                        "result": "Failed",
                        "elapsedTime": [],
                        "details": []
                    },
                    {
                        "testId": "Magnetic",
                        "result": "Skipped",
                        "elapsedTime": [],
                        "details": []
                    },
                    {
                        "testId": "Call",
                        "result": "Passed",
                        "elapsedTime": [],
                        "details": []
                    },
                    {
                        "testId": "Charge",
                        "result": "Passed",
                        "elapsedTime": [],
                        "details": [
                            {
                                "context": "ChargeWired",
                                "title": "Wired",
                                "result": "Passed",
                                "value": ""
                            },
                            {
                                "context": "ChargeWireless",
                                "title": "Wireless",
                                "result": "NA",
                                "value": "Not Tested"
                            }
                        ]
                    },
                    {
                        "testId": "Wifi",
                        "result": "Passed",
                        "elapsedTime": [],
                        "details": []
                    },
                    {
                        "testId": "Bluetooth",
                        "result": "Passed",
                        "elapsedTime": [],
                        "details": []
                    },
                    {
                        "testId": "Gps",
                        "result": "Passed",
                        "elapsedTime": [],
                        "details": []
                    },
                    {
                        "testId": "Nfc",
                        "result": "Failed",
                        "elapsedTime": [],
                        "details": []
                    },
                    {
                        "testId": "Lidar",
                        "result": "Passed",
                        "elapsedTime": [],
                        "details": []
                    },
                    {
                        "testId": "Biometric",
                        "result": "Passed",
                        "elapsedTime": [],
                        "details": [
                            {
                                "context": "BiometricFaceIdCondition",
                                "title": "Face ID has passed Quick Diagnostics",
                                "result": "NA",
                                "value": ""
                            }
                        ]
                    }
                ],
                "gradingResult": {
                    "createdAt": "2025-01-01T12:00:00+00:00",
                    "modificationTimestamp": "2025-01-01T12:00:00+00:00",
                    "screen": 5,
                    "back": 4,
                    "phoneCase": 3,
                    "lcd": 5,
                    "secondScreen": 0,
                    "secondLcd": 0,
                    "housing": 0,
                    "accessories": [
                        "OriginalBox",
                        "Papers",
                        "UsbCable",
                        "Charger",
                        "Receipt",
                        "Headset",
                        "SimTool"
                    ],
                    "comment": "Sample comment"
                }
            }
        ],
        "hasMore": false,
        "totalCount": 1
    },
    "meta": {
        "success": true
    }
}