<!--
{
  "availability" : [
    "iOS: 10.0.0 -",
    "iPadOS: 10.0.0 -",
    "macCatalyst: 13.1.0 -",
    "visionOS: 1.0.0 -",
    "watchOS: 3.2.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "SiriKit",
  "identifier" : "/documentation/Intents/INSearchForMessagesIntentHandling",
  "metadataVersion" : "0.1.0",
  "role" : "Protocol",
  "symbol" : {
    "kind" : "Protocol",
    "modules" : [
      "Intents"
    ],
    "preciseIdentifier" : "c:objc(pl)INSearchForMessagesIntentHandling"
  },
  "title" : "INSearchForMessagesIntentHandling"
}
-->

# INSearchForMessagesIntentHandling

An interface that handles requests to search the current user’s messages.

```
protocol INSearchForMessagesIntentHandling : NSObjectProtocol
```

## Overview

Use the methods of the [`INSearchForMessagesIntentHandling`](/documentation/Intents/INSearchForMessagesIntentHandling) protocol to resolve, confirm, and handle requests to search the current user’s messages. Adopt this protocol in an object of your Intents extension capable of searching your app’s messages.

Siri delivers an [`INSearchForMessagesIntent`](/documentation/Intents/INSearchForMessagesIntent) object to your handler when the user asks to search their messages. The provided intent object contains the search parameters to use when matching messages. Use the methods of this protocol to resolve the search parameters, to perform the search, and to return the results.

## Topics

### Resolving the Intent Parameters

[`-  resolveRecipientsForSearchForMessages:withCompletion:`](/documentation/Intents/INSearchForMessagesIntentHandling/resolveRecipients(for:with:))

Resolves the user’s input when they search for messages sent to specific people.

[`-  resolveSendersForSearchForMessages:withCompletion:`](/documentation/Intents/INSearchForMessagesIntentHandling/resolveSenders(for:with:))

Resolves the user’s input when they search for messages sent by specific people.

[`-  resolveAttributesForSearchForMessages:withCompletion:`](/documentation/Intents/INSearchForMessagesIntentHandling/resolveAttributes(for:with:))

Resolves the user’s input when they search for messages with specific attributes.

[`-  resolveDateTimeRangeForSearchForMessages:withCompletion:`](/documentation/Intents/INSearchForMessagesIntentHandling/resolveDateTimeRange(for:with:))

Resolves the user’s input when they search for messages sent in a specific time period.

[`-  resolveSpeakableGroupNamesForSearchForMessages:withCompletion:`](/documentation/Intents/INSearchForMessagesIntentHandling/resolveSpeakableGroupNames(for:with:))

Resolves the user’s input when they search for messages sent to a specific group of people.

[`-  resolveGroupNamesForSearchForMessages:withCompletion:`](/documentation/Intents/INSearchForMessagesIntentHandling/resolveGroupNames(for:with:))

Resolves the user’s input when they search for messages sent to a specific group of people.

### Confirming the Response

[`-  confirmSearchForMessages:completion:`](/documentation/Intents/INSearchForMessagesIntentHandling/confirm(intent:completion:))

Confirms whether you can perform the search.

### Handling the Intent

[`-  handleSearchForMessages:completion:`](/documentation/Intents/INSearchForMessagesIntentHandling/handle(intent:completion:))

Performs the search and returns the results.

## Relationships

### Inherits From

[`NSObjectProtocol`](/documentation/ObjectiveC/NSObjectProtocol)

### Inherited By

[`INMessagesDomainHandling`](/documentation/Intents/INMessagesDomainHandling)

---

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)