<!--
{
  "availability" : [
    "iOS: 10.3.0 -",
    "iPadOS: 10.3.0 -",
    "macCatalyst: 13.1.0 -",
    "visionOS: 1.0.0 -",
    "watchOS: 3.2.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "SiriKit",
  "identifier" : "/documentation/Intents/INPerson/siriMatches",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Property",
  "symbol" : {
    "kind" : "Instance Property",
    "modules" : [
      "Intents"
    ],
    "preciseIdentifier" : "c:objc(cs)INPerson(py)siriMatches"
  },
  "title" : "siriMatches"
}
-->

# siriMatches

The list of matches Siri provides for you to resolve or disambiguate.

```
var siriMatches: [INPerson]? { get }
```

## Discussion

When attempting to resolve the recipient of a message, use this property to determine how to respond:

- If the array contains a single match and your app successfully identifies that person by their [`contactIdentifier`](/documentation/Intents/INPerson/contactIdentifier) or [`customIdentifier`](/documentation/Intents/INPerson/customIdentifier), use the [`success(with:)`](/documentation/Intents/INPersonResolutionResult/success(with:)) method to resolve the recipient.
- If the array contains multiple people and those people each have distinct [`contactIdentifier`](/documentation/Intents/INPerson/contactIdentifier) or [`customIdentifier`](/documentation/Intents/INPerson/customIdentifier) values, ignore any your app can’t identify and then respond according to the number of remaining matches. For example, if there are still two or more matches, use the [`disambiguation(with:)`](/documentation/Intents/INPersonResolutionResult/disambiguation(with:)) method to ask the person interacting with Siri to choose.
- If the array contains multiple people and they all have the same [`contactIdentifier`](/documentation/Intents/INPerson/contactIdentifier), disambiguate using [`personHandle`](/documentation/Intents/INPerson/personHandle) instead. If your app doesn’t use handles, simply pass any match to the [`success(with:)`](/documentation/Intents/INPersonResolutionResult/success(with:)) method.
- If the array is empty or the property is `nil`, search your app’s contacts for people matching those in the [`recipients`](/documentation/Intents/INSendMessageIntent/recipients) property of [`INSendMessageIntent`](/documentation/Intents/INSendMessageIntent) instead. Use the resolution method that best describes the outcome of that search.

---

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)