---
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 the first computer with the given name

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

# 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": {
    "/computers/name/{name}/subset/{subset}": {
      "get": {
        "tags": [
          "computers"
        ],
        "summary": "Finds a subset of data for the first computer with the given name",
        "description": "Subset values can also be appended using an ampersand to return multiple subsets (e.g. /subsets/General&Hardware)",
        "operationId": "findComputersByNameSubset",
        "parameters": [
          {
            "name": "name",
            "in": "path",
            "required": true,
            "description": "Name to filter by",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "subset",
            "in": "path",
            "required": true,
            "description": "Subset to filter by",
            "schema": {
              "type": "string",
              "enum": [
                "General",
                "Location",
                "Purchasing",
                "Peripherals",
                "Hardware",
                "Certificates",
                "Software",
                "ExtensionAttributes",
                "GroupsAccounts",
                "iphones",
                "ConfigurationProfiles"
              ]
            }
          }
        ],
        "deprecated": true,
        "x-deprecation-date": "2025-02-11",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/xml": {
                "schema": {
                  "$ref": "#/components/schemas/computer"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/computer"
                }
              }
            }
          }
        }
      }
    }
  },
  "servers": [
    {
      "url": "https://yourServer.jamfcloud.com/JSSResource"
    }
  ],
  "components": {
    "securitySchemes": {
      "basicAuth": {
        "type": "http",
        "scheme": "basic"
      }
    },
    "schemas": {
      "size": {
        "type": "integer",
        "example": 1
      },
      "attachment": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "example": 1
          },
          "filename": {
            "type": "string",
            "example": "icon.png"
          },
          "uri": {
            "type": "string",
            "example": "https://example.jamfcloud/attachment.html?id=1&o=r"
          }
        }
      },
      "computer": {
        "type": "object",
        "properties": {
          "general": {
            "type": "object",
            "properties": {
              "id": {
                "type": "integer",
                "example": 1
              },
              "name": {
                "type": "string",
                "example": "Admins iMac",
                "description": "Name of computer"
              },
              "mac_address": {
                "type": "string",
                "example": "E0:AC:CB:97:36:G4"
              },
              "network_adapter_type": {
                "type": "string",
                "example": "Ethernet"
              },
              "alt_mac_address": {
                "type": "string",
                "example": "E0:AC:CB:97:36:G4"
              },
              "alt_network_adapter_type": {
                "type": "string",
                "example": "IEEE80211"
              },
              "ip_address": {
                "type": "string",
                "example": "10.1.1.1"
              },
              "last_reported_ip": {
                "type": "string",
                "example": "192.0.0.1"
              },
              "serial_number": {
                "type": "string",
                "example": "C02Q7KHTGFWF"
              },
              "udid": {
                "type": "string",
                "example": "55900BDC-347C-58B1-D249-F32244B11D30"
              },
              "jamf_version": {
                "type": "string",
                "example": "9.99.0-t1494340586"
              },
              "platform": {
                "type": "string",
                "example": "Mac"
              },
              "barcode_1": {
                "type": "string"
              },
              "barcode_2": {
                "type": "string"
              },
              "asset_tag": {
                "type": "string"
              },
              "remote_management": {
                "type": "object",
                "properties": {
                  "managed": {
                    "type": "boolean"
                  },
                  "management_username deprecated=\"10.48\"": {
                    "type": "string",
                    "example": "deprecated"
                  }
                }
              },
              "mdm_capable": {
                "type": "boolean"
              },
              "mdm_capable_users": {
                "type": "object",
                "properties": {
                  "mdm_capable_user": {
                    "type": "string"
                  }
                }
              },
              "management_status": {
                "type": "object",
                "properties": {
                  "enrolled_via_dep": {
                    "type": "boolean"
                  },
                  "user_approved_enrollment": {
                    "type": "boolean"
                  },
                  "user_approved_mdm": {
                    "type": "boolean"
                  }
                }
              },
              "report_date": {
                "type": "string",
                "example": "2017-07-07 18:37:04"
              },
              "report_date_epoch": {
                "type": "integer",
                "example": 1499470624555
              },
              "report_date_utc": {
                "type": "string",
                "example": "2017-07-07T18:37:04.555-0500"
              },
              "last_contact_time": {
                "type": "string",
                "example": "2017-07-07 18:37:04"
              },
              "last_contact_time_epoch": {
                "type": "integer",
                "example": 1499470624555
              },
              "last_contact_time_utc": {
                "type": "string",
                "example": "2017-07-07T18:37:04.555-0500"
              },
              "initial_entry_date": {
                "type": "string",
                "example": "2017-07-07 18:37:04"
              },
              "initial_entry_date_epoch": {
                "type": "integer",
                "example": 1499470624555
              },
              "initial_entry_date_utc": {
                "type": "string",
                "example": "2017-07-07T18:37:04.555-0500"
              },
              "last_cloud_backup_date_epoch": {
                "type": "integer",
                "example": 1499470624555
              },
              "last_cloud_backup_date_utc": {
                "type": "string",
                "example": "2017-07-07T18:37:04.555-0500"
              },
              "last_enrolled_date_epoch": {
                "type": "integer",
                "example": 1499470624555
              },
              "last_enrolled_date_utc": {
                "type": "string",
                "example": "2017-07-07T18:37:04.555-0500"
              },
              "distribution_point": {
                "type": "string"
              },
              "sus": {
                "type": "string"
              },
              "site": {
                "$ref": "#/components/schemas/site_object"
              },
              "itunes_store_account_is_active": {
                "type": "boolean"
              }
            }
          },
          "location": {
            "$ref": "#/components/schemas/location"
          },
          "purchasing": {
            "$ref": "#/components/schemas/purchasing"
          },
          "peripherals": {
            "properties": {
              "size": {
                "$ref": "#/components/schemas/size"
              },
              "peripherals": {
                "type": "array",
                "items": {
                  "properties": {
                    "peripheral": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "integer",
                          "example": 1
                        },
                        "bar_code_1": {
                          "type": "string"
                        },
                        "bar_code_2": {
                          "type": "string"
                        },
                        "type": {
                          "type": "string",
                          "description": "Name of the peripheral type",
                          "example": "Peripheral Type Name"
                        },
                        "fields": {
                          "type": "object",
                          "properties": {
                            "field": {
                              "type": "object",
                              "properties": {
                                "name": {
                                  "type": "string",
                                  "example": "Peripheral Field Name"
                                },
                                "value": {
                                  "type": "string",
                                  "example": "Value for menu type"
                                }
                              }
                            }
                          }
                        }
                      }
                    },
                    "purchasing": {
                      "$ref": "#/components/schemas/purchasing"
                    },
                    "attachments": {
                      "type": "array",
                      "items": {
                        "properties": {
                          "size": {
                            "$ref": "#/components/schemas/size"
                          },
                          "attachment": {
                            "$ref": "#/components/schemas/attachment"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "hardware": {
            "type": "object",
            "properties": {
              "make": {
                "type": "string",
                "example": "Apple"
              },
              "model": {
                "type": "string",
                "example": "13-inch Retina MacBook Pro (Late 2013)"
              },
              "model_identifier": {
                "type": "string",
                "example": "MacBookPro11,1"
              },
              "os_name": {
                "type": "string",
                "example": "Mac OS X"
              },
              "os_version": {
                "type": "string",
                "example": "10.13.2"
              },
              "os_build": {
                "type": "string",
                "example": "17C88"
              },
              "master_password_set": {
                "type": "boolean"
              },
              "active_directory_status": {
                "type": "string",
                "example": "AD.company.com"
              },
              "service_pack": {
                "type": "string"
              },
              "processor_type": {
                "type": "string",
                "example": "Intel Core i5"
              },
              "processor_architechture": {
                "type": "string",
                "example": "x86_64"
              },
              "processor_speed": {
                "type": "string",
                "example": 2600
              },
              "processor_speed_mhz": {
                "type": "string",
                "example": 2600
              },
              "number_processors": {
                "type": "integer",
                "example": 1
              },
              "number_cores": {
                "type": "integer",
                "example": 2
              },
              "total_ram": {
                "type": "integer",
                "example": 16384
              },
              "total_ram_mb": {
                "type": "integer",
                "example": 16384
              },
              "boot_rom": {
                "type": "string",
                "example": "MBP111.0142.B00"
              },
              "bus_speed": {
                "type": "integer",
                "example": 0
              },
              "bus_speed_mhz": {
                "type": "integer",
                "example": 0
              },
              "battery_capacity": {
                "type": "integer",
                "example": 90
              },
              "cache_size": {
                "type": "integer",
                "example": 3072
              },
              "cache_size_kb": {
                "type": "integer",
                "example": 3072
              },
              "available_ram_slots": {
                "type": "integer",
                "example": 0
              },
              "optical_drive": {
                "type": "string"
              },
              "nic_speed": {
                "type": "string",
                "example": "n/a"
              },
              "smc_version": {
                "type": "string",
                "example": "2.16f68"
              },
              "ble_capable": {
                "type": "boolean"
              },
              "sip_status": {
                "type": "string",
                "enum": [
                  "Enabled",
                  "Disabled"
                ]
              },
              "gatekeeper_status": {
                "type": "string",
                "example": "App Store and identified developers"
              },
              "xprotect_version": {
                "type": "string",
                "example": 2098
              },
              "institutional_recovery_key": {
                "type": "string",
                "example": "Not Present"
              },
              "disk_encryption_configuration": {
                "type": "string",
                "example": "Individual and Institutional Encryption"
              },
              "filevault_2_users": {
                "type": "array",
                "items": {
                  "properties": {
                    "user": {
                      "type": "string",
                      "example": "admin"
                    }
                  }
                }
              },
              "storage": {
                "type": "array",
                "items": {
                  "properties": {
                    "device": {
                      "type": "object",
                      "properties": {
                        "disk": {
                          "type": "string",
                          "example": "disk0"
                        },
                        "model": {
                          "type": "string",
                          "example": "Apple SSD SM0512F"
                        },
                        "revision": {
                          "type": "string",
                          "example": "UXM2JA1Q"
                        },
                        "serial_number": {
                          "type": "string",
                          "example": "S1K5NYADC12934"
                        },
                        "size": {
                          "type": "integer",
                          "example": 512287
                        },
                        "drive_capacity_mb": {
                          "type": "integer",
                          "example": 512287
                        },
                        "connection_type": {
                          "type": "string",
                          "example": "NO"
                        },
                        "smart_status": {
                          "type": "string",
                          "example": "Verified"
                        },
                        "partition": {
                          "type": "array",
                          "items": {
                            "properties": {
                              "name": {
                                "type": "string",
                                "example": "Macintosh HD"
                              },
                              "size": {
                                "type": "integer",
                                "example": 94128
                              },
                              "type": {
                                "type": "string",
                                "example": "boot"
                              },
                              "partition_capacity_mb": {
                                "type": "integer",
                                "example": 94128
                              },
                              "percentage_full": {
                                "type": "integer",
                                "example": 17
                              },
                              "filevault_status": {
                                "type": "string",
                                "example": "Encrypted"
                              },
                              "filevault_percent": {
                                "type": "integer",
                                "example": 100
                              },
                              "filevault2_status": {
                                "type": "string",
                                "example": "Encrypted"
                              },
                              "filevault2_percent": {
                                "type": "integer",
                                "example": 100
                              },
                              "boot_drive_available_mb": {
                                "type": "integer",
                                "example": 425198
                              },
                              "lvgUUID": {
                                "type": "string"
                              },
                              "lvUUID": {
                                "type": "string"
                              },
                              "pvUUID": {
                                "type": "string"
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                }
              },
              "mapped_printers": {
                "type": "array",
                "items": {
                  "properties": {
                    "printer": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "example": "2nd Floor HP"
                        },
                        "uri": {
                          "type": "string",
                          "example": "lpd://10.11.182.21/"
                        },
                        "type": {
                          "type": "string",
                          "example": "HP LaserJet 500 color MFP M575"
                        },
                        "location": {
                          "type": "string",
                          "example": "2nd Floor / Stairwell"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "certificates": {
            "type": "array",
            "items": {
              "properties": {
                "certificate": {
                  "type": "object",
                  "properties": {
                    "common_name": {
                      "type": "string",
                      "example": "JSS Built-in Certificate Authority"
                    },
                    "identify": {
                      "type": "boolean",
                      "example": false
                    },
                    "expires_utc": {
                      "type": "string",
                      "example": "2024-03-02T02:12:49.000+0000"
                    },
                    "expires_epoch": {
                      "type": "integer",
                      "example": 1709345569000
                    },
                    "name": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "security": {
            "type": "object",
            "properties": {
              "activation_lock": {
                "type": "boolean",
                "example": false
              },
              "recovery_lock_enabled": {
                "type": "boolean",
                "example": false
              },
              "secure_boot_level": {
                "type": "string",
                "example": "unknown"
              },
              "external_boot_level": {
                "type": "string",
                "example": "unknown"
              },
              "firewall_enabled": {
                "type": "boolean",
                "example": false
              }
            }
          },
          "software": {
            "type": "object",
            "properties": {
              "unix_executables": {
                "type": "string"
              },
              "licensed_software": {
                "type": "array",
                "items": {
                  "properties": {
                    "name": {
                      "type": "string",
                      "example": "Adobe CS5"
                    }
                  }
                }
              },
              "installed_by_casper": {
                "type": "array",
                "items": {
                  "properties": {
                    "package": {
                      "type": "string",
                      "example": "FireFox.pkg"
                    }
                  }
                }
              },
              "installed_by_installer_swu": {
                "type": "array",
                "items": {
                  "properties": {
                    "package": {
                      "type": "string",
                      "example": "com.apple.pkg.iTunesX"
                    }
                  }
                }
              },
              "cached_by_casper": {
                "type": "array",
                "items": {
                  "properties": {
                    "package": {
                      "type": "string",
                      "example": "GoogleChrome.pkg"
                    }
                  }
                }
              },
              "available_software_updates": {
                "type": "array",
                "items": {
                  "properties": {
                    "name": {
                      "type": "string",
                      "example": "iTunesXPatch-12.7.3"
                    }
                  }
                }
              },
              "available_updates": {
                "type": "array",
                "items": {
                  "properties": {
                    "update": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "example": "iTunes"
                        },
                        "package_name": {
                          "type": "string",
                          "example": "iTunesXPatch-12.7.3"
                        },
                        "version": {
                          "type": "string",
                          "example": "12.7.3"
                        }
                      }
                    }
                  }
                }
              },
              "running_services": {
                "type": "array",
                "items": {
                  "properties": {
                    "name": {
                      "type": "string",
                      "example": "com.apple.airportd"
                    }
                  }
                }
              },
              "applications": {
                "type": "array",
                "items": {
                  "properties": {
                    "size": {
                      "$ref": "#/components/schemas/size"
                    },
                    "application": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "example": "Activity Monitor.app"
                        },
                        "path": {
                          "type": "string",
                          "example": "/Applications/Utilities/Activity Monitor.app"
                        },
                        "version": {
                          "type": "string",
                          "example": 10.13
                        }
                      }
                    }
                  }
                }
              },
              "fonts": {
                "type": "array",
                "items": {
                  "properties": {
                    "size": {
                      "$ref": "#/components/schemas/size"
                    },
                    "font": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "example": "Al Nile.ttc"
                        },
                        "path": {
                          "type": "string",
                          "example": "/Library/Fonts/Al Nile.ttc"
                        },
                        "version": {
                          "type": "string",
                          "example": "n/a"
                        }
                      }
                    }
                  }
                }
              },
              "plugins": {
                "type": "array",
                "items": {
                  "properties": {
                    "size": {
                      "$ref": "#/components/schemas/size"
                    },
                    "plugin": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "example": "QuickTime Plugin.plugin"
                        },
                        "path": {
                          "type": "string",
                          "example": "/Library/Internet Plug-Ins/Disabled Plug-Ins/QuickTime Plugin.plugin"
                        },
                        "version": {
                          "type": "string",
                          "example": "7.7.3"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "extension_attributes": {
            "type": "array",
            "items": {
              "properties": {
                "extension_attribute": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "integer",
                      "example": 1
                    },
                    "name": {
                      "type": "string",
                      "example": "Battery Cycle Count"
                    },
                    "type": {
                      "type": "string",
                      "example": "String"
                    },
                    "value": {
                      "type": "string",
                      "example": 191
                    }
                  }
                }
              }
            }
          },
          "groups_accounts": {
            "type": "object",
            "properties": {
              "computer_group_memberships": {
                "type": "array",
                "items": {
                  "properties": {
                    "group": {
                      "type": "string",
                      "example": "All Managed Clients"
                    }
                  }
                }
              },
              "local_accounts": {
                "type": "array",
                "items": {
                  "properties": {
                    "user": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "example": "_amavisd"
                        },
                        "realname": {
                          "type": "string",
                          "example": "AMaViS Daemon"
                        },
                        "uid": {
                          "type": "string",
                          "example": 83
                        },
                        "home": {
                          "type": "string",
                          "example": "/var/virusmails"
                        },
                        "home_size": {
                          "type": "string",
                          "example": "-1MB"
                        },
                        "home_size_mb": {
                          "type": "string",
                          "example": -1
                        },
                        "administrator": {
                          "type": "boolean",
                          "example": false
                        },
                        "filevault_enabled": {
                          "type": "boolean",
                          "example": false
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "configuration_profiles": {
            "type": "array",
            "items": {
              "properties": {
                "size": {
                  "$ref": "#/components/schemas/size"
                },
                "configuration_profile": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "integer",
                      "example": 1
                    },
                    "name": {
                      "type": "string"
                    },
                    "uuid": {
                      "type": "string"
                    },
                    "is_removable": {
                      "type": "boolean",
                      "example": false
                    }
                  }
                }
              }
            }
          }
        }
      },
      "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
          }
        }
      },
      "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"
          }
        }
      },
      "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"
        ]
      }
    }
  }
}
```