---
updatedAt: 2025-09-14T23:44:13.000Z
agentTools:
  siteIndex: https://developer.jamf.com/llms.txt
  projectIndex: https://developer.jamf.com/jamf-pro/v11.14.0/llms.txt
---

# Finds a subset of computer history data by name

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

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "version": "11.12.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,
    "proxy-enabled": true
  },
  "paths": {
    "/computerhistory/name/{name}/subset/{subset}": {
      "get": {
        "tags": [
          "computerhistory"
        ],
        "summary": "Finds a subset of computer history data by name",
        "description": "Subset values can also be appended using an ampersand to return multiple subsets (e.g. /subsets/General&Commands)",
        "operationId": "findComputerHistoryByNameSubset",
        "parameters": [
          {
            "name": "name",
            "in": "path",
            "required": true,
            "description": "Computer Name to filter by",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "subset",
            "in": "path",
            "required": true,
            "description": "Subset to filter by",
            "schema": {
              "type": "string",
              "enum": [
                "General",
                "ComputerUsageLogs",
                "Audits",
                "PolicyLogs",
                "CasperRemoteLogs",
                "ScreenSharingLogs",
                "CasperImagingLogs",
                "Commands",
                "UserLocation",
                "MacAppStoreApplications"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/xml": {
                "schema": {
                  "$ref": "#/components/schemas/computer_history"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/computer_history"
                }
              }
            }
          }
        }
      }
    }
  },
  "x-si-base": "swagger.yaml",
  "x-github-repo": "jamf/Classic-API-Swagger-Specification",
  "x-github-sha": "070fac498a589aaa0958641a68e4065584fc244a",
  "servers": [
    {
      "url": "https://yourServer.jamfcloud.com/JSSResource"
    }
  ],
  "components": {
    "securitySchemes": {
      "basicAuth": {
        "type": "http",
        "scheme": "basic"
      }
    },
    "schemas": {
      "computer_history": {
        "type": "object",
        "properties": {
          "general": {
            "type": "object",
            "properties": {
              "id": {
                "type": "integer",
                "example": 1
              },
              "name": {
                "type": "string",
                "example": "Admins MacBook Pro",
                "description": "Name of the computer"
              },
              "udid": {
                "type": "string",
                "example": "55900BDC-347C-58B1-D249-F32244B11D30"
              },
              "serial_number": {
                "type": "string",
                "example": "C02Q7KHTGFWF"
              },
              "mac_address": {
                "type": "string",
                "example": "E0:AC:CB:97:36:G4"
              }
            }
          },
          "computer_usage_logs": {
            "type": "array",
            "items": {
              "properties": {
                "usage_log": {
                  "properties": {
                    "event": {
                      "type": "string",
                      "example": "login"
                    },
                    "username": {
                      "type": "string",
                      "example": "Admin"
                    },
                    "date_time": {
                      "type": "string",
                      "example": "2017-07-07T18:37:04.000Z"
                    },
                    "date_time_epoch": {
                      "type": "string",
                      "example": 1499470624555
                    },
                    "date_time_utc": {
                      "type": "string",
                      "example": "2017-07-07T18:37:04.555-0500"
                    }
                  }
                }
              }
            }
          },
          "audits": {
            "type": "array",
            "items": {
              "properties": {
                "audit": {
                  "properties": {
                    "event": {
                      "type": "string",
                      "example": "Viewed FileVault Encryption Key"
                    },
                    "username": {
                      "type": "string",
                      "example": "Jamf Pro Admin"
                    },
                    "date_time": {
                      "type": "string",
                      "example": "2017-07-07T18:37:04.000Z"
                    },
                    "date_time_epoch": {
                      "type": "string",
                      "example": 1499470624555
                    },
                    "date_time_utc": {
                      "type": "string",
                      "example": "2017-07-07T18:37:04.555-0500"
                    }
                  }
                }
              }
            }
          },
          "policy_logs": {
            "type": "array",
            "items": {
              "properties": {
                "policy_log": {
                  "properties": {
                    "policy_id": {
                      "type": "integer",
                      "example": 1
                    },
                    "policy_name": {
                      "type": "string",
                      "example": "Update Inventory"
                    },
                    "username": {
                      "type": "string",
                      "example": "Username"
                    },
                    "date_time": {
                      "type": "string",
                      "example": "2017-07-07T18:37:04.000Z"
                    },
                    "date_time_epoch": {
                      "type": "string",
                      "example": 1499470624555
                    },
                    "date_time_utc": {
                      "type": "string",
                      "example": "2017-07-07T18:37:04.555-0500"
                    },
                    "status": {
                      "type": "string",
                      "example": "Completed"
                    }
                  }
                }
              }
            }
          },
          "casper_remote_logs": {
            "type": "array",
            "items": {
              "properties": {
                "casper_remote_log": {
                  "properties": {
                    "date_time": {
                      "type": "string",
                      "example": "2017-07-07T18:37:04.000Z"
                    },
                    "date_time_epoch": {
                      "type": "string",
                      "example": 1499470624555
                    },
                    "date_time_utc": {
                      "type": "string",
                      "example": "2017-07-07T18:37:04.555-0500"
                    },
                    "status": {
                      "type": "string",
                      "example": "Completed"
                    }
                  }
                }
              }
            }
          },
          "screen_sharing_logs": {
            "type": "array",
            "items": {
              "properties": {
                "screen_sharing_log": {
                  "properties": {
                    "date_time": {
                      "type": "string",
                      "example": "2017-07-07T18:37:04.000Z"
                    },
                    "date_time_epoch": {
                      "type": "string",
                      "example": 1499470624555
                    },
                    "date_time_utc": {
                      "type": "string",
                      "example": "2017-07-07T18:37:04.555-0500"
                    },
                    "status": {
                      "type": "string",
                      "example": "Completed"
                    },
                    "details": {
                      "type": "string",
                      "example": "admin authenticated to screen share with computer at 10.1.1.1"
                    }
                  }
                }
              }
            }
          },
          "casper_imaging_logs": {
            "type": "array",
            "items": {
              "properties": {
                "casper_imaging_log": {
                  "properties": {
                    "date_time": {
                      "type": "string",
                      "example": "2017-07-07T18:37:04.000Z"
                    },
                    "date_time_epoch": {
                      "type": "string",
                      "example": 1499470624555
                    },
                    "date_time_utc": {
                      "type": "string",
                      "example": "2017-07-07T18:37:04.555-0500"
                    },
                    "status": {
                      "type": "string",
                      "example": "Completed"
                    }
                  }
                }
              }
            }
          },
          "commands": {
            "type": "object",
            "properties": {
              "completed": {
                "type": "array",
                "items": {
                  "properties": {
                    "command": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "example": "WiFi Configuration Profile"
                        },
                        "completed": {
                          "type": "string",
                          "example": "2017/07/07 at 6:37 PM"
                        },
                        "completed_epoch": {
                          "type": "string",
                          "example": 1499470624555
                        },
                        "completed_utc": {
                          "type": "string",
                          "example": "2017-07-07T18:37:04.555-0500"
                        },
                        "username": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              },
              "pending": {
                "type": "array",
                "items": {
                  "properties": {
                    "command": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "example": "ProfileList"
                        },
                        "status": {
                          "type": "string",
                          "example": "Pending"
                        },
                        "issued": {
                          "type": "string",
                          "example": "2017/07/07 at 6:37 PM"
                        },
                        "issued_epoch": {
                          "type": "string",
                          "example": 1499470624555
                        },
                        "issued_utc": {
                          "type": "string",
                          "example": "2017-07-07T18:37:04.555-0500"
                        },
                        "last_push": {
                          "type": "string",
                          "example": "2017/07/07 at 6:38 PM"
                        },
                        "last_push_epoch": {
                          "type": "string",
                          "example": 1499470735555
                        },
                        "last_push_utc": {
                          "type": "string",
                          "example": "2017-07-07T18:38:55.555-0500"
                        },
                        "username": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              },
              "failed": {
                "type": "array",
                "items": {
                  "properties": {
                    "command": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "example": "Install Configuration Profile AD Binding"
                        },
                        "status": {
                          "type": "string",
                          "example": "The Directory Binding Account payload could not be installed"
                        },
                        "issued": {
                          "type": "string",
                          "example": "2017/07/07 at 6:37 PM"
                        },
                        "issued_epoch": {
                          "type": "string",
                          "example": 1499470624555
                        },
                        "issued_utc": {
                          "type": "string",
                          "example": "2017-07-07T18:37:04.555-0500"
                        },
                        "failed": {
                          "type": "string",
                          "example": "2017/07/07 at 6:38 PM"
                        },
                        "failed_epoch": {
                          "type": "string",
                          "example": 1499470735555
                        },
                        "failed_utc": {
                          "type": "string",
                          "example": "2017-07-07T18:38:55.555-0500"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "user_location": {
            "type": "array",
            "items": {
              "properties": {
                "location": {
                  "type": "object",
                  "properties": {
                    "date_time": {
                      "type": "string",
                      "example": "2017/07/07 at 6:37 PM"
                    },
                    "date_time_epoch": {
                      "type": "string",
                      "example": 1499470624555
                    },
                    "date_time_utc": {
                      "type": "string",
                      "example": "2017-07-07T18:37:04.555-0500"
                    },
                    "username": {
                      "type": "string",
                      "example": "Betty.Johnson"
                    },
                    "full_name": {
                      "type": "string",
                      "example": "Betty Johnson"
                    },
                    "email_address": {
                      "type": "string",
                      "example": "betty.johnson@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": 134
                    },
                    "position": {
                      "type": "string",
                      "example": "Chief of Everything"
                    }
                  }
                }
              }
            }
          },
          "mac_app_store_applications": {
            "type": "object",
            "properties": {
              "installed": {
                "type": "array",
                "items": {
                  "properties": {
                    "app": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "example": "Xcode"
                        },
                        "version": {
                          "type": "string",
                          "example": "8.3.3"
                        },
                        "size_mb": {
                          "type": "string",
                          "example": 150
                        }
                      }
                    }
                  }
                }
              },
              "pending": {
                "type": "array",
                "items": {
                  "properties": {
                    "app": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "example": "Xcode"
                        },
                        "version": {
                          "type": "string",
                          "example": "8.3.2"
                        },
                        "deployed": {
                          "type": "string",
                          "example": "2 minutes ago"
                        },
                        "deployed_epoch": {
                          "type": "integer",
                          "example": 1499470624555
                        },
                        "deployed_utc": {
                          "type": "string",
                          "example": "2018-02-22T16:55:14.000-0600"
                        },
                        "last_update": {
                          "type": "string",
                          "example": "2 minutes ago"
                        },
                        "last_update_epoch": {
                          "type": "integer",
                          "example": 1499470624555
                        },
                        "last_update_utc": {
                          "type": "string",
                          "example": "2018-02-22T16:55:14.000-0600"
                        }
                      }
                    }
                  }
                }
              },
              "failed": {
                "type": "array",
                "items": {
                  "properties": {
                    "app": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "example": "Xcode"
                        },
                        "version": {
                          "type": "string",
                          "example": "8.3.2"
                        },
                        "status": {
                          "type": "string",
                          "example": "Failed"
                        },
                        "deployed": {
                          "type": "string",
                          "example": "2 minutes ago"
                        },
                        "deployed_epoch": {
                          "type": "integer",
                          "example": 1499470624555
                        },
                        "deployed_utc": {
                          "type": "string",
                          "example": "2018-02-22T16:55:14.000-0600"
                        },
                        "last_update": {
                          "type": "string",
                          "example": "2 minutes ago"
                        },
                        "last_update_epoch": {
                          "type": "integer",
                          "example": 1499470624555
                        },
                        "last_update_utc": {
                          "type": "string",
                          "example": "2018-02-22T16:55:14.000-0600"
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
```