M360 Customer API documentation

POST scheduleBlacklistCheck

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

Schedules a blacklist check for the specified IMEI numbers. The check runs asynchronously, and you can retrieve the results once they’re ready. Each IMEI number costs 1 blacklist check token.

Request parameters

NameTypeDescription
imeiList array A list of IMEI numbers to perform the blacklist check for. The list can include up to 1,000 IMEI numbers. Required, 1 - 1000 elements, All.
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 BlacklistCheckBatchResult object This is the data object of the response of the scheduleBlacklistCheck and getBlacklistChecksByBatchId API endpoints.

Examples

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

{
    "imeiList": [
        "566171972540345",
        "446416547821353",
        "357838080687454",
        "566171972540345"
    ]
}
Response application/json
{
    "data": {
        "batchId": "bc883c8b-46d3-ef73-924d-23005e7e8e13",
        "createdAt": "2024-10-02T13:23:10",
        "batchSize": 3,
        "result": null,
        "status": "queued",
        "availableTokens": 1297
    },
    "meta": {
        "success": true
    }
}
400 Bad Request POST https://m360soft.com/api/customer/v2/scheduleBlacklistCheck
Request
POST https://m360soft.com/api/customer/v2/scheduleBlacklistCheckContent-Type: application/json
Response application/json
{
    "data": [],
    "meta": {
        "success": false,
        "errors": {
            "code": "validation:parameter_error",
            "title": "One or more parameters are missing or invalid",
            "details": {
                "imeiList": [
                    "This value should not be blank."
                ]
            }
        }
    }
}