<!--
{
  "availability" : [
    "iOS: 9.0.0 -",
    "iPadOS: 9.0.0 -",
    "macCatalyst: 13.0.0 -",
    "macOS: 13.0.0 -",
    "visionOS: 1.0.0 -",
    "watchOS: 2.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "HealthKit",
  "identifier" : "/documentation/HealthKit/HKQuery/predicateForObjects(from:)-9h87f",
  "metadataVersion" : "0.1.0",
  "role" : "Type Method",
  "symbol" : {
    "kind" : "Type Method",
    "modules" : [
      "HealthKit"
    ],
    "preciseIdentifier" : "c:objc(cs)HKQuery(cm)predicateForObjectsFromDevices:"
  },
  "title" : "predicateForObjects(from:)"
}
-->

# predicateForObjects(from:)

Returns a predicate that matches all the objects that were created by any of the provided devices.

```
class func predicateForObjects(from devices: Set<HKDevice>) -> NSPredicate
```

## Parameters

`devices`

A set of devices that have generated the data for objects stored in the HealthKit store.

## Return Value

A predicate that matches all the objects that store data generated by any of the provided devices.

## Discussion

When creating the device objects for this predicate, only pass in values for the parameters you need for your query. HealthKit returns all the devices that match the non-`nil` parameters. This gives you a great deal of control when it comes to fine tuning your query. For example, setting the `localIdentifier` and the `firmwareVersion` parameters lets you query for all the samples generated by a specific device running a specific version of the firmware. Just setting the `manufacturer` and `model` casts a much broader net.

The following sample uses both the convenience method and a predicate format string to create equivalent predicates.

```objc
NSPredicate *fromDevices = [HKQuery predicateForObjectsFromDevices:devices];
 
NSPredicate *explicitFromDevices = [NSPredicate predicateWithFormat:@"%K IN %@",
                                    HKPredicateKeyPathDevice,
                                    devices];
```

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)