---
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 device history by UDID

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

# 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": {
    "/mobiledevicehistory/udid/{udid}/subset/{subset}": {
      "get": {
        "tags": [
          "mobiledevicehistory"
        ],
        "summary": "Finds a subset of data for mobile device history by UDID",
        "description": "Subset values can also be appended using an ampersand to return multiple subsets (e.g. /subsets/General&Audits)",
        "operationId": "findMobileDeviceHistoryByUDIDSubset",
        "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",
                "ManagementCommands",
                "UserLocation",
                "Audits",
                "Applications",
                "Ebooks"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/xml": {
                "schema": {
                  "$ref": "#/components/schemas/mobile_device_history"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/mobile_device_history"
                }
              }
            }
          }
        }
      }
    }
  },
  "servers": [
    {
      "url": "https://yourServer.jamfcloud.com/JSSResource"
    }
  ],
  "components": {
    "securitySchemes": {
      "basicAuth": {
        "type": "http",
        "scheme": "basic"
      }
    },
    "schemas": {
      "mobile_device_history": {
        "type": "object",
        "properties": {
          "general": {
            "type": "object",
            "properties": {
              "id": {
                "type": "integer",
                "example": 1
              },
              "name": {
                "type": "string",
                "example": "Jesses iPad",
                "description": "Name of the device"
              },
              "udid": {
                "type": "string",
                "example": "270aae10800b6e61a2ee2bbc285eb967050b5984"
              },
              "serial_number": {
                "type": "string",
                "example": "C02Q7KHTGFWF"
              },
              "mac_address": {
                "type": "string",
                "example": "E0:AC:CB:97:36:G4"
              }
            }
          },
          "management_commands": {
            "type": "object",
            "properties": {
              "completed": {
                "type": "array",
                "items": {
                  "properties": {
                    "command": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "example": "Profile List"
                        },
                        "date_time_completed": {
                          "type": "string",
                          "example": "2017/09/19 at 1:02 PM"
                        },
                        "date_time_completed_epoch": {
                          "type": "integer",
                          "example": 1505844136509
                        }
                      }
                    }
                  }
                }
              },
              "pending": {
                "type": "array",
                "items": {
                  "properties": {
                    "command": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "example": "Profile List"
                        },
                        "date_time_issued": {
                          "type": "string",
                          "example": "2017/09/19 at 1:02 PM"
                        },
                        "date_time_issued_epoch": {
                          "type": "string",
                          "example": 1505844136509
                        },
                        "date_time_failed": {
                          "type": "string"
                        },
                        "date_time_failed_epoch": {
                          "type": "integer",
                          "example": 0
                        }
                      }
                    }
                  }
                }
              },
              "failed": {
                "type": "array",
                "items": {
                  "properties": {
                    "command": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "example": "DeviceLocation"
                        },
                        "date_time_issued": {
                          "type": "string",
                          "example": "2017/09/19 at 1:02 PM"
                        },
                        "date_time_issued_epoch": {
                          "type": "string",
                          "example": 1505844136509
                        },
                        "date_time_failed": {
                          "type": "string"
                        },
                        "date_time_failed_epoch": {
                          "type": "integer",
                          "example": 0
                        },
                        "error": {
                          "type": "string",
                          "example": "The location of the device could not be determined."
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "user_location": {
            "type": "array",
            "items": {
              "properties": {
                "location": {
                  "type": "object",
                  "properties": {
                    "date_time": {
                      "type": "string",
                      "example": "2017/09/19 at 1:02 PM"
                    },
                    "date_time_epoch": {
                      "type": "integer",
                      "example": 1505844136509
                    },
                    "username": {
                      "type": "string",
                      "example": "AHarrison"
                    },
                    "full_name": {
                      "type": "string",
                      "example": "Ashley Harrison"
                    },
                    "email_address": {
                      "type": "string",
                      "example": "ashley.harrison@company.com"
                    },
                    "phone_number": {
                      "type": "string",
                      "example": "555-555-5555"
                    },
                    "department": {
                      "type": "string",
                      "example": "Information Technology"
                    },
                    "building": {
                      "type": "string",
                      "example": "Block D"
                    },
                    "room": {
                      "type": "string",
                      "example": 287
                    },
                    "position": {
                      "type": "string",
                      "example": "Chief of Chiefs"
                    }
                  }
                }
              }
            }
          },
          "audits": {
            "type": "array",
            "items": {
              "properties": {
                "audit": {
                  "type": "object",
                  "properties": {
                    "event": {
                      "type": "string",
                      "example": "Viewed Activation Lock Bypass Code"
                    },
                    "username": {
                      "type": "string",
                      "example": "Jamf Pro Admin"
                    },
                    "date_time": {
                      "type": "string",
                      "example": "2017/09/19 at 1:02 PM"
                    },
                    "date_time_epoch": {
                      "type": "integer",
                      "example": 1505844136509
                    }
                  }
                }
              }
            }
          },
          "applications": {
            "type": "object",
            "properties": {
              "installed": {
                "type": "array",
                "items": {
                  "properties": {
                    "in_house_from_mobile_device_app_catalog": {
                      "$ref": "#/components/schemas/mobile_device_history_app"
                    },
                    "app_store_from_mobile_device_app_catalog": {
                      "$ref": "#/components/schemas/mobile_device_history_app"
                    },
                    "other": {
                      "$ref": "#/components/schemas/mobile_device_history_app"
                    }
                  }
                }
              },
              "pending": {
                "type": "array",
                "items": {
                  "properties": {
                    "app": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "example": "Angry Birds"
                        },
                        "version": {
                          "type": "string",
                          "example": "1.0.0"
                        },
                        "management_status": {
                          "type": "string",
                          "example": "Pending"
                        }
                      }
                    }
                  }
                }
              },
              "failed": {
                "type": "array",
                "items": {
                  "properties": {
                    "app": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "example": "Angry Birds"
                        },
                        "version": {
                          "type": "string",
                          "example": "1.0.0"
                        },
                        "management_status": {
                          "type": "string",
                          "example": "Failed"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "ebooks": {
            "type": "object",
            "properties": {
              "installed": {
                "type": "object",
                "properties": {
                  "inhouse": {
                    "type": "array",
                    "items": {
                      "properties": {
                        "title": {
                          "type": "string",
                          "example": "iPhone Users Guide for iOS 11.2"
                        },
                        "author": {
                          "type": "string",
                          "example": "Apple Inc."
                        },
                        "version": {
                          "type": "string",
                          "example": "1.0.0"
                        },
                        "kind": {
                          "type": "string"
                        },
                        "management_status": {
                          "type": "string",
                          "example": "Managed"
                        }
                      }
                    }
                  },
                  "ibookstore": {
                    "type": "array",
                    "items": {
                      "properties": {
                        "title": {
                          "type": "string",
                          "example": "iPhone Users Guide for iOS 11.2"
                        },
                        "author": {
                          "type": "string",
                          "example": "Apple Inc."
                        },
                        "version": {
                          "type": "string",
                          "example": "1.0.0"
                        },
                        "kind": {
                          "type": "string"
                        },
                        "management_status": {
                          "type": "string",
                          "example": "Managed"
                        }
                      }
                    }
                  }
                }
              },
              "pending": {
                "type": "array",
                "items": {
                  "properties": {
                    "title": {
                      "type": "string",
                      "example": "iPhone Users Guide for iOS 11.2"
                    },
                    "author": {
                      "type": "string",
                      "example": "Apple Inc."
                    },
                    "version": {
                      "type": "string",
                      "example": "1.0.0"
                    },
                    "kind": {
                      "type": "string"
                    },
                    "management_status": {
                      "type": "string",
                      "example": "Managed"
                    }
                  }
                }
              },
              "failed": {
                "type": "array",
                "items": {
                  "properties": {
                    "title": {
                      "type": "string",
                      "example": "iPhone Users Guide for iOS 11.2"
                    },
                    "author": {
                      "type": "string",
                      "example": "Apple Inc."
                    },
                    "version": {
                      "type": "string",
                      "example": "1.0.0"
                    },
                    "kind": {
                      "type": "string"
                    },
                    "management_status": {
                      "type": "string",
                      "example": "Managed"
                    }
                  }
                }
              }
            }
          }
        }
      },
      "mobile_device_history_app": {
        "xml": {
          "name": "app"
        },
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "example": "Self Service Mobile"
          },
          "version": {
            "type": "string",
            "example": "10.1.1"
          },
          "management_status": {
            "type": "string",
            "enum": [
              "Unmanaged",
              "Managed"
            ]
          },
          "bundle_size": {
            "type": "string",
            "example": "3 MB"
          },
          "dynamic_size": {
            "type": "string",
            "example": "12 KB"
          }
        }
      }
    }
  }
}
```