---
updatedAt: 2026-06-16T18:46:24.000Z
agentTools:
  siteIndex: https://developer.jamf.com/llms.txt
  projectIndex: https://developer.jamf.com/jamf-pro/llms.txt
---

# Finds a subset of data for mobile devices by UDID

Subset values can also be appended using an ampersand to return multiple subsets (e.g. /subsets/General&Location)

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "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"
    }
  },
  "security": [
    {
      "basicAuth": []
    }
  ],
  "x-readme": {
    "samples-languages": [
      "curl",
      "swift",
      "ruby",
      "python"
    ],
    "explorer-enabled": false
  },
  "paths": {
    "/mobiledevices/udid/{udid}/subset/{subset}": {
      "get": {
        "tags": [
          "mobiledevices"
        ],
        "summary": "Finds a subset of data for mobile devices by UDID",
        "description": "Subset values can also be appended using an ampersand to return multiple subsets (e.g. /subsets/General&Location)",
        "operationId": "findMobileDevicesByUDIDSubset",
        "parameters": [
          {
            "name": "udid",
            "in": "path",
            "required": true,
            "description": "UDID to filter by",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "subset",
            "in": "path",
            "required": true,
            "description": "Subset to filter by",
            "schema": {
              "type": "string",
              "enum": [
                "General",
                "Location",
                "Purchasing",
                "Applications",
                "Security",
                "Network",
                "Certificates",
                "ConfigurationProfiles",
                "ProvisioningProfiles",
                "MobileDeviceGroups",
                "ExtensionAttributes"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/xml": {
                "schema": {
                  "$ref": "#/components/schemas/mobile_device"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/mobile_device"
                }
              }
            }
          }
        }
      }
    }
  },
  "servers": [
    {
      "url": "https://yourServer.jamfcloud.com/JSSResource"
    }
  ],
  "components": {
    "securitySchemes": {
      "basicAuth": {
        "type": "http",
        "scheme": "basic"
      }
    },
    "schemas": {
      "size": {
        "type": "integer",
        "example": 1
      },
      "id_name": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "example": 1
          },
          "name": {
            "type": "string"
          }
        }
      },
      "location": {
        "type": "object",
        "properties": {
          "username": {
            "type": "string",
            "example": "JBetty"
          },
          "realname": {
            "type": "string",
            "example": "Betty Jackson"
          },
          "real_name": {
            "type": "string",
            "example": "Betty Jackson"
          },
          "email_address": {
            "type": "string",
            "example": "jbetty@company.com"
          },
          "position": {
            "type": "string",
            "example": "Systems Engineer"
          },
          "phone": {
            "type": "string",
            "example": "123-555-6789"
          },
          "phone_number": {
            "type": "string",
            "example": "123-555-6789"
          },
          "department": {
            "type": "string",
            "example": "Sales Staff"
          },
          "building": {
            "type": "string",
            "example": "New York Office"
          },
          "room": {
            "type": "string",
            "example": 1159
          }
        }
      },
      "mobile_device": {
        "type": "object",
        "properties": {
          "general": {
            "type": "object",
            "properties": {
              "id": {
                "type": "integer",
                "example": 1
              },
              "display_name": {
                "type": "string",
                "example": "Tinas iPad"
              },
              "device_name": {
                "type": "string",
                "example": "Tinas iPad"
              },
              "name": {
                "type": "string",
                "example": "Tinas iPad"
              },
              "asset_tag": {
                "type": "string"
              },
              "last_inventory_update": {
                "type": "string",
                "example": "2017-07-07 18:37:04"
              },
              "last_inventory_update_epoch": {
                "type": "integer",
                "example": 1499470624555
              },
              "last_inventory_update_utc": {
                "type": "string",
                "example": "2017-07-07T18:37:04.555-0500"
              },
              "capacity": {
                "type": "integer",
                "example": 12159
              },
              "capacity_mb": {
                "type": "integer",
                "example": 12159
              },
              "available": {
                "type": "integer",
                "example": 11487
              },
              "available_mb": {
                "type": "integer",
                "example": 11487
              },
              "percentage_used": {
                "type": "integer",
                "example": 5
              },
              "os_type": {
                "type": "string",
                "example": "iOS"
              },
              "os_version": {
                "type": "string",
                "example": "10.3.2"
              },
              "os_build": {
                "type": "string",
                "example": "14F89"
              },
              "serial_number": {
                "type": "string",
                "example": "C02Q7KHTGFWF"
              },
              "udid": {
                "type": "string",
                "example": "270aae10800b6e61a2ee2bbc285eb967050b5984"
              },
              "initial_entry_date_epoch": {
                "type": "integer",
                "example": 1499470624555
              },
              "initial_entry_date_utc": {
                "type": "string",
                "example": "2017-07-07T18:37:04.555-0500"
              },
              "phone_number": {
                "type": "string",
                "example": "123-555-6789"
              },
              "ip_address": {
                "type": "string",
                "example": "192.0.0.1"
              },
              "wifi_mac_address": {
                "type": "string",
                "example": "E0:AC:CB:97:36:G4"
              },
              "bluetooth_mac_address": {
                "type": "string",
                "example": "E0:AC:CB:97:36:G6"
              },
              "modem_firmware": {
                "type": "string",
                "example": "2.61.00"
              },
              "model": {
                "type": "string",
                "example": "iPhone 6S"
              },
              "model_identifier": {
                "type": "string",
                "example": "iPhone8,1"
              },
              "model_number": {
                "type": "string",
                "example": "MKRY2LL"
              },
              "model_display": {
                "type": "string",
                "example": "iPhone 6S"
              },
              "device_ownership_level": {
                "type": "string",
                "example": "Institutional"
              },
              "last_enrollment_epoch": {
                "type": "integer",
                "example": 1499470624555
              },
              "last_enrollment_utc": {
                "type": "string",
                "example": "2017-07-07T18:37:04.555-0500"
              },
              "managed": {
                "type": "boolean"
              },
              "supervised": {
                "type": "boolean"
              },
              "exchange_activesync_device_identifier": {
                "type": "string",
                "example": "TUCLLFJHPL779ACL9DCJQFN39F"
              },
              "shared": {
                "type": "string"
              },
              "tethered": {
                "type": "string"
              },
              "battery_level": {
                "type": "integer",
                "example": 95
              },
              "ble_capable": {
                "type": "boolean"
              },
              "device_locator_service_enabled": {
                "type": "boolean"
              },
              "do_not_disturb_enabled": {
                "type": "boolean"
              },
              "cloud_backup_enabled": {
                "type": "boolean"
              },
              "last_cloud_backup_date_epoch": {
                "type": "integer",
                "example": 1499470624555
              },
              "last_cloud_backup_date_utc": {
                "type": "string",
                "example": "2017-07-07T18:37:04.555-0500"
              },
              "location_services_enabled": {
                "type": "boolean"
              },
              "itunes_store_account_is_active": {
                "type": "boolean"
              },
              "last_backup_time_epoch": {
                "type": "integer",
                "example": 1499470624555
              },
              "last_backup_time_utc": {
                "type": "string",
                "example": "2017-07-07T18:37:04.555-0500"
              }
            },
            "required": [
              "name",
              "udid",
              "serial_number"
            ]
          },
          "location": {
            "$ref": "#/components/schemas/location"
          },
          "purchasing": {
            "$ref": "#/components/schemas/purchasing"
          },
          "applications": {
            "type": "array",
            "items": {
              "properties": {
                "size": {
                  "$ref": "#/components/schemas/size"
                },
                "application": {
                  "type": "object",
                  "properties": {
                    "application_name": {
                      "type": "string",
                      "example": "Self Service Mobile"
                    },
                    "application_version": {
                      "type": "string",
                      "example": "10.1.1"
                    },
                    "identifier": {
                      "type": "string",
                      "example": "com.jamfsoftware.selfservice"
                    }
                  }
                }
              }
            }
          },
          "security_object": {
            "xml": {
              "name": "security"
            },
            "type": "object",
            "properties": {
              "data_protection": {
                "type": "boolean"
              },
              "block_level_encryption_capable": {
                "type": "boolean"
              },
              "file_level_encryption_capable": {
                "type": "boolean"
              },
              "passcode_present": {
                "type": "boolean"
              },
              "passcode_compliant": {
                "type": "boolean"
              },
              "passcode_compliant_with_profile": {
                "type": "boolean"
              },
              "passcode_lock_grace_period_enforced": {
                "type": "string",
                "example": "Not Available"
              },
              "hardware_encryption": {
                "type": "string"
              },
              "activation_lock_enabled": {
                "type": "boolean"
              },
              "jailbreak_detected": {
                "type": "string",
                "example": "Normal"
              },
              "lost_mode_enabled": {
                "type": "string",
                "example": true
              },
              "lost_mode_enforced": {
                "type": "boolean",
                "example": true
              },
              "lost_mode_enable_issued_epoch": {
                "type": "integer",
                "example": 1517598768512
              },
              "lost_mode_enable_issued_utc": {
                "type": "string",
                "example": "2018-02-02T13:12:48.512-0600"
              },
              "lost_mode_message": {
                "type": "string",
                "example": "Please return to Company"
              },
              "lost_mode_phone": {
                "type": "string",
                "example": "555-555-5555"
              },
              "lost_mode_footnote": {
                "type": "string"
              },
              "lost_location_epoch": {
                "type": "integer",
                "example": 1517598680459
              },
              "lost_location_utc": {
                "type": "string",
                "example": "2018-02-02T13:11:20.459-0600"
              },
              "lost_location_latitude": {
                "type": "string",
                "example": 44.81436821
              },
              "lost_location_longitude": {
                "type": "string",
                "example": -91.502672
              },
              "lost_location_altitude": {
                "type": "string",
                "example": 242.88067627
              },
              "lost_location_speed": {
                "type": "string",
                "example": -1
              },
              "lost_location_course": {
                "type": "string",
                "example": -1
              },
              "lost_location_horizontal_accuracy": {
                "type": "string",
                "example": 65
              },
              "lost_location_vertical_accuracy": {
                "type": "string",
                "example": 10
              }
            }
          },
          "network": {
            "type": "object",
            "properties": {
              "home_carrier_network": {
                "type": "string",
                "example": "Verizon"
              },
              "cellular_technology": {
                "type": "string",
                "example": "Unknown"
              },
              "voice_roaming_enabled": {
                "type": "string",
                "example": "Yes"
              },
              "imei": {
                "type": "string",
                "example": "35 200706 056227 1"
              },
              "iccid": {
                "type": "string",
                "example": "8914 8000 0010 0254 6259"
              },
              "current_carrier_network": {
                "type": "string"
              },
              "carrier_settings_version": {
                "type": "string",
                "example": 20
              },
              "current_mobile_country_code": {
                "type": "string",
                "example": 311
              },
              "current_mobile_network_code": {
                "type": "string",
                "example": 480
              },
              "home_mobile_country_code": {
                "type": "string",
                "example": 311
              },
              "home_mobile_network_code": {
                "type": "string",
                "example": 480
              },
              "data_roaming_enabled": {
                "type": "boolean"
              },
              "phone_number": {
                "type": "string",
                "example": 5555555555
              }
            }
          },
          "certificates": {
            "type": "array",
            "items": {
              "properties": {
                "size": {
                  "$ref": "#/components/schemas/size"
                },
                "certificate": {
                  "type": "object",
                  "properties": {
                    "common_name": {
                      "type": "string",
                      "example": "JSS Built-in Certificate Authority"
                    },
                    "identity": {
                      "type": "boolean"
                    }
                  }
                }
              }
            }
          },
          "configuration_profiles": {
            "type": "array",
            "items": {
              "properties": {
                "size": {
                  "$ref": "#/components/schemas/size"
                },
                "configuration_profile": {
                  "type": "object",
                  "properties": {
                    "display_name": {
                      "type": "string",
                      "example": "WiFi"
                    },
                    "version": {
                      "type": "integer",
                      "example": 1
                    },
                    "identifier": {
                      "type": "string",
                      "example": "279889AF-1564-4480-A61D-860DF5EFDF26"
                    },
                    "uuid": {
                      "type": "string",
                      "example": "279889AF-1564-4480-A61D-860DF5EFDF26"
                    }
                  }
                }
              }
            }
          },
          "provisioning_profiles": {
            "type": "array",
            "items": {
              "properties": {
                "size": {
                  "$ref": "#/components/schemas/size"
                },
                "mobile_device_provisioning_profile": {
                  "type": "object",
                  "properties": {
                    "display_name": {
                      "type": "string",
                      "example": "In-House App Provisioning Profile"
                    },
                    "expiration_date": {
                      "type": "string",
                      "example": "2018-01-29"
                    },
                    "expiration_date_epoch": {
                      "type": "integer"
                    },
                    "expiration_date_utc": {
                      "type": "string",
                      "example": "2018-01-29T14:18:02.000-0600"
                    },
                    "uuid": {
                      "type": "string",
                      "example": "279889AF-1564-4480-A61D-860DF5EFDF26"
                    }
                  }
                }
              }
            }
          },
          "mobile_device_groups": {
            "type": "array",
            "items": {
              "properties": {
                "size": {
                  "$ref": "#/components/schemas/size"
                },
                "mobile_device_group": {
                  "$ref": "#/components/schemas/id_name"
                }
              }
            }
          },
          "extension_attributes": {
            "type": "array",
            "items": {
              "properties": {
                "id": {
                  "type": "integer",
                  "example": 1
                },
                "name": {
                  "type": "string",
                  "example": "Asset Selector"
                },
                "type": {
                  "type": "string",
                  "example": "String"
                },
                "value": {
                  "type": "string",
                  "example": "Sample Value"
                }
              }
            }
          }
        }
      },
      "purchasing": {
        "type": "object",
        "properties": {
          "is_purchased": {
            "type": "boolean"
          },
          "is_leased": {
            "type": "boolean"
          },
          "po_number": {
            "type": "string"
          },
          "vendor": {
            "type": "string"
          },
          "applecare_id": {
            "type": "string"
          },
          "purchase_price": {
            "type": "string"
          },
          "purchasing_account": {
            "type": "string"
          },
          "po_date": {
            "type": "string"
          },
          "po_date_epoch": {
            "type": "integer"
          },
          "po_date_utc": {
            "type": "string"
          },
          "warranty_expires": {
            "type": "string"
          },
          "warranty_expires_epoch": {
            "type": "integer"
          },
          "warranty_expires_utc": {
            "type": "string"
          },
          "lease_expires": {
            "type": "string"
          },
          "lease_expires_epoch": {
            "type": "integer"
          },
          "lease_expires_utc": {
            "type": "string"
          },
          "life_expectancy": {
            "type": "integer"
          },
          "purchasing_contact": {
            "type": "string"
          }
        }
      }
    }
  }
}
```