---
updatedAt: 2026-08-29T02:46:19.000Z
agentTools:
  siteIndex: https://developer.jamf.com/llms.txt
  projectIndex: https://developer.jamf.com/platform-api/llms.txt
---

# Finds mobile device searches by ID

**Required Permissions:** `advanced-device-searches:read`

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "version": "11.32.0",
    "title": "Classic API",
    "license": {
      "name": "Jamf API License Agreement",
      "url": "https://developer.jamf.com/developer-guide/docs/api-license-agreement"
    },
    "description": "Jamf Pro Classic API for legacy device management, configuration, and automation.",
    "termsOfService": "https://www.jamf.com/developer-resources/api-license-agreement/",
    "contact": {
      "name": "Jamf Developer",
      "url": "https://developer.jamf.com"
    }
  },
  "security": [
    {
      "oauth2": []
    }
  ],
  "x-readme": {
    "samples-languages": [
      "curl",
      "swift",
      "ruby",
      "python"
    ],
    "explorer-enabled": false
  },
  "paths": {
    "/advancedmobiledevicesearches/id/{id}": {
      "get": {
        "tags": [
          "advancedmobiledevicesearches"
        ],
        "summary": "Finds mobile device searches by ID",
        "operationId": "findAdvancedMobileDeviceSearchesById",
        "parameters": [
          {
            "$ref": "#/components/parameters/X-Tenant-Id"
          },
          {
            "$ref": "#/components/parameters/X-Environment-Id"
          },
          {
            "description": "ID value to filter by",
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/xml": {
                "schema": {
                  "$ref": "#/components/schemas/advanced_mobile_device_search"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/advanced_mobile_device_search"
                }
              }
            }
          }
        },
        "security": [
          {
            "oauth2": [
              "advanced-device-searches:read"
            ]
          }
        ],
        "x-required-privileges": [
          "advanced-device-searches:read"
        ],
        "description": "**Required Permissions:** `advanced-device-searches:read`"
      }
    }
  },
  "servers": [
    {
      "url": "https://{region}.api.jamfcloud.com/proclassic",
      "description": "Jamf Beta API Gateway - prod",
      "variables": {
        "region": {
          "default": "us",
          "enum": [
            "us",
            "eu",
            "apac"
          ],
          "description": "Geographic deployment region"
        }
      }
    }
  ],
  "components": {
    "securitySchemes": {
      "oauth2": {
        "type": "oauth2",
        "description": "Obtain an access token by calling the API Gateway's token endpoint using the OAuth2 client-credentials flow.",
        "flows": {
          "clientCredentials": {
            "tokenUrl": "https://{region}.api.jamfcloud.com/auth/token",
            "scopes": {
              "accounts:create": "",
              "accounts:delete": "",
              "accounts:read": "",
              "accounts:update": "",
              "activation-code:read": "",
              "activation-code:update": "",
              "advanced-device-searches:create": "",
              "advanced-device-searches:delete": "",
              "advanced-device-searches:read": "",
              "advanced-device-searches:update": "",
              "advanced-user-searches:create": "",
              "advanced-user-searches:delete": "",
              "advanced-user-searches:read": "",
              "advanced-user-searches:update": "",
              "allowed-file-extension:create": "",
              "allowed-file-extension:delete": "",
              "allowed-file-extension:read": "",
              "applications:create": "",
              "applications:delete": "",
              "applications:read": "",
              "applications:update": "",
              "buildings:create": "",
              "buildings:delete": "",
              "buildings:read": "",
              "buildings:update": "",
              "categories:create": "",
              "categories:delete": "",
              "categories:read": "",
              "categories:update": "",
              "classes:create": "",
              "classes:delete": "",
              "classes:read": "",
              "classes:update": "",
              "computer-check-in:read": "",
              "computer-check-in:update": "",
              "computer-inventory-collection-settings:read": "",
              "computer-inventory-collection-settings:update": "",
              "configuration-profiles:create": "",
              "configuration-profiles:delete": "",
              "configuration-profiles:read": "",
              "configuration-profiles:update": "",
              "departments:create": "",
              "departments:delete": "",
              "departments:read": "",
              "departments:update": "",
              "destructive-device-actions:execute": "",
              "device-actions:delete": "",
              "device-actions:execute": "",
              "device-actions:read": "",
              "device-groups:create": "",
              "device-groups:delete": "",
              "device-groups:read": "",
              "device-groups:update": "",
              "device-history:read": "",
              "devices:create": "",
              "devices:read": "",
              "devices:update": "",
              "directory-bindings:create": "",
              "directory-bindings:delete": "",
              "directory-bindings:read": "",
              "directory-bindings:update": "",
              "disk-encryption-configurations:create": "",
              "disk-encryption-configurations:delete": "",
              "disk-encryption-configurations:read": "",
              "disk-encryption-configurations:update": "",
              "distribution-points:create": "",
              "distribution-points:delete": "",
              "distribution-points:read": "",
              "distribution-points:update": "",
              "dock-items:create": "",
              "dock-items:delete": "",
              "dock-items:read": "",
              "dock-items:update": "",
              "ebooks:create": "",
              "ebooks:delete": "",
              "ebooks:read": "",
              "ebooks:update": "",
              "enrollment-invitations:create": "",
              "enrollment-invitations:delete": "",
              "enrollment-invitations:read": "",
              "enrollment-invitations:update": "",
              "enrollment-profiles:create": "",
              "enrollment-profiles:delete": "",
              "enrollment-profiles:read": "",
              "enrollment-profiles:update": "",
              "extension-attributes:create": "",
              "extension-attributes:delete": "",
              "extension-attributes:read": "",
              "extension-attributes:update": "",
              "file-uploads:create": "",
              "flush-policy-logs:execute": "",
              "gsx-connection:read": "",
              "gsx-connection:update": "",
              "ibeacon:create": "",
              "ibeacon:delete": "",
              "ibeacon:read": "",
              "ibeacon:update": "",
              "infrastructure-managers:create": "",
              "infrastructure-managers:delete": "",
              "infrastructure-managers:read": "",
              "infrastructure-managers:update": "",
              "json-web-token-configuration:create": "",
              "json-web-token-configuration:delete": "",
              "json-web-token-configuration:read": "",
              "json-web-token-configuration:update": "",
              "ldap-servers:create": "",
              "ldap-servers:delete": "",
              "ldap-servers:read": "",
              "ldap-servers:update": "",
              "licensed-software:create": "",
              "licensed-software:delete": "",
              "licensed-software:read": "",
              "licensed-software:update": "",
              "network-segments:create": "",
              "network-segments:delete": "",
              "network-segments:read": "",
              "network-segments:update": "",
              "packages:create": "",
              "packages:delete": "",
              "packages:read": "",
              "packages:update": "",
              "patch-external-source:create": "",
              "patch-external-source:delete": "",
              "patch-external-source:read": "",
              "patch-external-source:update": "",
              "patch-internal-source:read": "",
              "patch-management-software-titles:create": "",
              "patch-management-software-titles:delete": "",
              "patch-management-software-titles:read": "",
              "patch-management-software-titles:update": "",
              "patch-policies:create": "",
              "patch-policies:delete": "",
              "patch-policies:read": "",
              "patch-policies:update": "",
              "policies:create": "",
              "policies:delete": "",
              "policies:read": "",
              "policies:update": "",
              "printers:create": "",
              "printers:delete": "",
              "printers:read": "",
              "printers:update": "",
              "provisioning-profiles:create": "",
              "provisioning-profiles:delete": "",
              "provisioning-profiles:read": "",
              "provisioning-profiles:update": "",
              "removable-mac-address:create": "",
              "removable-mac-address:delete": "",
              "removable-mac-address:read": "",
              "removable-mac-address:update": "",
              "restricted-software:create": "",
              "restricted-software:delete": "",
              "restricted-software:read": "",
              "restricted-software:update": "",
              "scripts:create": "",
              "scripts:delete": "",
              "scripts:read": "",
              "scripts:update": "",
              "sites:create": "",
              "sites:delete": "",
              "sites:read": "",
              "sites:update": "",
              "smtp-server:read": "",
              "smtp-server:update": "",
              "software-update-servers:create": "",
              "software-update-servers:delete": "",
              "software-update-servers:read": "",
              "software-update-servers:update": "",
              "user-extension-attributes:create": "",
              "user-extension-attributes:delete": "",
              "user-extension-attributes:read": "",
              "user-extension-attributes:update": "",
              "user-groups:create": "",
              "user-groups:delete": "",
              "user-groups:read": "",
              "user-groups:update": "",
              "users:create": "",
              "users:delete": "",
              "users:read": "",
              "users:update": "",
              "volume-purchasing-locations:create": "",
              "volume-purchasing-locations:delete": "",
              "volume-purchasing-locations:read": "",
              "volume-purchasing-locations:update": "",
              "webhooks:create": "",
              "webhooks:delete": "",
              "webhooks:read": "",
              "webhooks:update": ""
            }
          }
        }
      }
    },
    "schemas": {
      "size": {
        "type": "integer",
        "example": 1
      },
      "advanced_mobile_device_search": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "example": 1
          },
          "name": {
            "description": "Name of the advanced mobile device search",
            "type": "string",
            "example": "Advanced Search Name"
          },
          "view_as": {
            "type": "string",
            "example": "Standard Web Page"
          },
          "sort_1": {
            "type": "string"
          },
          "sort_2": {
            "type": "string"
          },
          "sort_3": {
            "type": "string"
          },
          "criteria": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "size": {
                  "$ref": "#/components/schemas/size"
                },
                "criterion": {
                  "$ref": "#/components/schemas/criterion"
                }
              }
            }
          },
          "display_fields": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "size": {
                  "$ref": "#/components/schemas/size"
                },
                "display_field": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "example": "IP Address",
                      "description": "Name of the display field"
                    }
                  }
                }
              }
            }
          },
          "mobile_devices": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "size": {
                  "$ref": "#/components/schemas/size"
                },
                "mobile_device": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "integer",
                      "example": 1
                    },
                    "name": {
                      "type": "string",
                      "example": "Tinas iPad",
                      "description": "Name of the mobile device"
                    },
                    "udid": {
                      "type": "string",
                      "example": "270aae10800b6e61a2ee2bbc285eb967050b5984"
                    },
                    "Display_Name": {
                      "type": "string",
                      "example": "Tinas iPad"
                    }
                  }
                }
              }
            }
          },
          "site": {
            "$ref": "#/components/schemas/site_object"
          }
        },
        "required": [
          "name"
        ]
      },
      "criterion": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "example": "Last Inventory Update",
            "description": "Name of the criteria"
          },
          "priority": {
            "type": "integer"
          },
          "and_or": {
            "type": "string",
            "enum": [
              "and",
              "or"
            ]
          },
          "search_type": {
            "type": "string",
            "example": "more than x days ago",
            "description": "Operator"
          },
          "value": {
            "type": "string",
            "example": 7
          },
          "opening_paren": {
            "type": "boolean",
            "default": false
          },
          "closing_paren": {
            "type": "boolean",
            "default": false
          }
        }
      },
      "site_object": {
        "type": "object",
        "xml": {
          "name": "site"
        },
        "properties": {
          "id": {
            "type": "integer",
            "default": -1
          },
          "name": {
            "type": "string",
            "example": "None",
            "description": "Name of the site"
          }
        },
        "required": [
          "name"
        ]
      }
    },
    "parameters": {
      "X-Tenant-Id": {
        "name": "X-Tenant-Id",
        "in": "header",
        "required": false,
        "description": "The tenant UUID identifier. Send it to address tenant scope. This API is also published at environment scope — send that scope's header instead. Send exactly one scope header per request.",
        "schema": {
          "type": "string",
          "format": "uuid",
          "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
          "example": "e77c1408-10c8-4007-b177-abc9157fbcaa"
        }
      },
      "X-Environment-Id": {
        "name": "X-Environment-Id",
        "in": "header",
        "required": false,
        "description": "The environment UUID identifier. Send it to address environment scope. This API is also published at tenant scope — send that scope's header instead. Send exactly one scope header per request.",
        "schema": {
          "type": "string",
          "format": "uuid",
          "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
          "example": "e77c1408-10c8-4007-b177-abc9157fbcaa"
        }
      }
    }
  },
  "x-scope-types": [
    "tenant",
    "environment"
  ]
}
```