We're excited to announce the general availability of the Sophos Mobile API. This API lets customers manage their devices enrolled with Sophos Mobile, and is particularly useful for customers who want to integrate with existing workflows or 3rd party tools.

Using the API

Sophos Central admins must set up API credentials to use the Sophos Mobile API. For details on setting up API credentials please see the Getting Started guide. Customers can then use tools such as Postman or curl to run API commands.

Once set up, admins can query for information about mobile devices and perform actions. This includes details such as listing device users, the last time a device synced, the OS version or compliance status. Admins can trigger a sync command to devices as well as sending a message to a user.

Examples

Device details

To get information about a tenant's mobile devices, use:

Fullscreen
1
GET /mobile/v1/devices/{id}?view=full
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

This returns details like the below:

Fullscreen
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
{
"id": "dd40830b-b103-4f9a-ae02-bbf0d792466d", //ID of the mobile device
"tenant": {
"id": "b8a75c7d-7492-4009-9f95-8c815551dc55" //Tenant of the mobile device
},
"name": "Chromebook 2687", //Name of the mobile device
"description": "", //A description for the mobile device
"phoneNumber": "", //The device's phone number configured in Sophos Mobile, if available
"email": "user@example.com", //Email of the user assigned to the device
"assignedPerson": {
"id": "9f059011-84c7-4849-ae2e-d0563743e485", //ID of the assigned user
"name": "Simon Smith", //Name of the assigned user
"email": "user@example.com" //Email of the assigned user
},
"healthState": {
"state": "amber", //Health statuts of the mobile device
"mode": "automatic" //Health statuts mode of the mobile device
},
"ownershipType": "corporate", //Ownership Type indicates it's a company issued device
"createdAt": "2024-10-15T14:18:50.000Z", //Timestamp the mobile device was created in the system
"updatedAt": "2024-10-15T14:57:15.000Z", //Timestamp the mobile device was updated
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Run a scan

Intercept X for Mobile scans Android devices for malware. To trigger a malware scan use:

Fullscreen
1
POST /mobile/v1/actions/scan
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

In the request include the devices to be scanned:

Fullscreen
1
2
3
4
5
6
{
"endpoints": [ //A list of endpoints which should execute a scan
"dd40830b-b103-4f9a-ae02-bbf0d792466d",
"e7e88612-d9b1-4e2f-b248-f2fad48579e4"
]
}
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

More Information

The Mobile API Guide has additional examples, and the full details are available on the API reference page.

  • 1 comment
  • 0 members are here