Skip to content

Get IXM auto-enrollment

GET/settings/ixm-auto-enrollment

Mobile API · Settings

Get settings for Intercept X for Mobile auto enrollments.

Required permissionmobile.settings:read

Parameters

Name In Type Required Description
X-Tenant-ID header string (uuid) Yes Tenant ID.

Request samples

curl -X GET "https://api-<data-region>.central.sophos.com/mobile/v1/settings/ixm-auto-enrollment" -H "Authorization: Bearer <access-token>" -H "X-Tenant-ID: <tenant-id>"


import requests

response = requests.get(
    "https://api-<data-region>.central.sophos.com/mobile/v1/settings/ixm-auto-enrollment",
    headers={
        "Authorization": "Bearer <access-token>",
        "X-Tenant-ID": "<tenant-id>",
    },
)
print(response.json())


$headers = @{
    "Authorization" = "Bearer <access-token>"
    "X-Tenant-ID" = "<tenant-id>"
}
Invoke-RestMethod -Method GET -Uri "https://api-<data-region>.central.sophos.com/mobile/v1/settings/ixm-auto-enrollment" -Headers $headers


package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, err := http.NewRequest("GET", "https://api-<data-region>.central.sophos.com/mobile/v1/settings/ixm-auto-enrollment", nil)
    if err != nil {
        panic(err)
    }
    req.Header.Set("Authorization", "Bearer <access-token>")
    req.Header.Set("X-Tenant-ID", "<tenant-id>")

    resp, err := http.DefaultClient.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}


const response = await fetch("https://api-<data-region>.central.sophos.com/mobile/v1/settings/ixm-auto-enrollment", {
  method: "GET",
  headers: {
    "Authorization": "Bearer <access-token>",
    "X-Tenant-ID": "<tenant-id>",
  },
});
const data = await response.json();
console.log(data);

Responses

200 — Settings for IXM auto enrollments.

Response fields

tenantobjectrequired
Tenant this resource belongs to.
Show child attributesHide child attributes
idstring (uuid)required
namestring
deviceGroupobjectrequired
A device group reference.
Show child attributesHide child attributes
idstring (uuid)required
Unique ID of the device group.
namestring
The device group name.
ownershipTypestring (enum)required
The ownership type of the mobile device.
Must be one of: corporate, employee.
createdByobject
Principal reference.
Show child attributesHide child attributes
idstring (uuid)
Principal ID.
typestring (enum)required
Principal type.
Must be one of: user, service, system.
accountIdstring (uuid)
Account ID.
accountTypestring (enum)
Account type.
Must be one of: partner, tenant, organization.
namestring
Principal name or email.
createdAtstring (date-time)
Indicates when the policy was created.
updatedByobject
Principal reference.
Show child attributesHide child attributes
idstring (uuid)
Principal ID.
typestring (enum)required
Principal type.
Must be one of: user, service, system.
accountIdstring (uuid)
Account ID.
accountTypestring (enum)
Account type.
Must be one of: partner, tenant, organization.
namestring
Principal name or email.
updatedAtstring (date-time)
Indicates when the policy was last updated.
androidPolicyobject
A policy reference.
Show child attributesHide child attributes
idstring (uuid)required
Unique ID of the device.
namestring
Unique name of the policy.
platformstring (enum)
The device platform, i.e. the operating system.
Must be one of: iOS, macOS, android, chrome, windows.
typestring
The policy type.
versionstring
The policy version.
iosPolicyobject
A policy reference.
Show child attributesHide child attributes
idstring (uuid)required
Unique ID of the device.
namestring
Unique name of the policy.
platformstring (enum)
The device platform, i.e. the operating system.
Must be one of: iOS, macOS, android, chrome, windows.
typestring
The policy type.
versionstring
The policy version.
connectionCodestring
The connection code required for automated enrollment on iOS and Android.

Errors

Status Meaning
400 Invalid request.
401 Unauthorized.
403 Forbidden.
404 Can't find configured setup data for Intercept X for Mobile auto enrollments.
429 Too many requests. See Retry-After header.
500 Internal server error.

All error responses share the same shape — see the error response object.

Response examples

200

{
  "tenant": {
    "id": "b8a75c7d-7492-4009-9f95-8c815551dc55",
    "name": "The name of the tenant"
  },
  "deviceGroup": {
    "id": "d602034d-a509-4c93-ade0-61f5b496c963",
    "name": "A device group"
  },
  "ownershipType": "corporate",
  "androidPolicy": {
    "id": "ea1735cc-d321-4a39-a61a-7ec4a5975e1d",
    "name": "My Android policy",
    "platform": "android",
    "type": "threatDefense",
    "version": 1
  },
  "iosPolicy": {
    "id": "15539043-4ec1-4525-bf2d-646e4f5d8212",
    "name": "My iOS policy",
    "platform": "iOS",
    "type": "threatDefense",
    "version": 1
  },
  "connectionCode": "eyJ0b2tlbiI6ImZvb28iLCJjdXN0b21lcmlkIjoiNDgyNzY5Ii widXJsIjoic21jLWRldmljZS1pZi1jbG91ZHN0YXRpb24tZXUt d2VzdC0xLnRlc3QuaHlkcmEuc29waG9zLmNvbSIsImNoZWNraW 5VcmkiOiJodHRwczovL3NtYy1kZXZpY2UtaWYtY2xvdWRzdGF0 aW9uLWV1LXdlc3QtMS50ZXN0Lmh5ZHJhLnNvcGhvcy5jb20vY2 xpZW50LWFwaS9lbnJvbGwvYXV0by1jb25maWd1cmVkL2l4bS9i OGE3NWM3ZC03NDkyLTQwMDktOWY5NS04YzgxMjQ1NTFkYzU1L2 NoZWNraW4ifQ==",
  "createdAt": "2025-01-02T08:50:00.300Z",
  "createdBy": {
    "id": "dfa19b8f-5898-4be9-b0dc-45a320ce76b1",
    "type": "user",
    "accountType": "tenant",
    "accountId": "0ea17949-d95c-4f58-95b7-ba6d9860f5fc",
    "name": "john.smith@example.com"
  },
  "updatedAt": "2025-01-02T08:50:01.300Z",
  "updatedBy": {
    "id": "dfa19b8f-5898-4be9-b0dc-45a320ce76b1",
    "type": "user",
    "accountType": "tenant",
    "accountId": "0ea17949-d95c-4f58-95b7-ba6d9860f5fc",
    "name": "john.smith@example.com"
  }
}

See the guide for a narrative walkthrough of this API.