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

# INSearchCallHistoryIntentHandling

The handler interface for searching the user’s call history.

```
protocol INSearchCallHistoryIntentHandling : NSObjectProtocol
```

## Overview

Use the methods of the [`INSearchCallHistoryIntentHandling`](/documentation/Intents/INSearchCallHistoryIntentHandling) protocol to resolve, confirm, and handle requests to search for calls in the user’s call history. Adopt this protocol in an object of your Intents extension that’s capable of performing the search and finding any matching records. Siri doesn’t display the call information found during the search. After a successful search, Siri launches your app to display that information.

Siri delivers an [`INSearchCallHistoryIntent`](/documentation/Intents/INSearchCallHistoryIntent) object to your handler when the user asks to search their call history. The provided intent object contains the search parameters, such as any contacts involved in the call or the range of dates to search. Use the methods of this protocol to resolve the search parameters and to perform the search.

## Topics

### Resolving the Intent Parameters

[`-  resolveCallTypesForSearchCallHistory:withCompletion:`](/documentation/Intents/INSearchCallHistoryIntentHandling/resolveCallTypes(for:with:))

Resolves the search criteria for the call type.

[`-  resolveCallTypeForSearchCallHistory:withCompletion:`](/documentation/Intents/INSearchCallHistoryIntentHandling/resolveCallType(for:with:))

Resolves the search criteria for the call type.

[`-  resolveRecipientForSearchCallHistory:withCompletion:`](/documentation/Intents/INSearchCallHistoryIntentHandling/resolveRecipient(for:with:))

Resolves the search criteria for the recipients.

[`-  resolveDateCreatedForSearchCallHistory:withCompletion:`](/documentation/Intents/INSearchCallHistoryIntentHandling/resolveDateCreated(for:with:))

Resolves the range of dates for the search.

[`-  resolveUnseenForSearchCallHistory:withCompletion:`](/documentation/Intents/INSearchCallHistoryIntentHandling/resolveUnseen(for:with:))

Resolves whether you can search for calls that the user hasn’t yet seen.

### Confirming the Response

[`-  confirmSearchCallHistory:completion:`](/documentation/Intents/INSearchCallHistoryIntentHandling/confirm(intent:completion:))

Confirms that you can perform the search.

### Handling the Intent

[`-  handleSearchCallHistory:completion:`](/documentation/Intents/INSearchCallHistoryIntentHandling/handle(intent:completion:))

Handles searching the user’s call history.

## Relationships

### Inherits From

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

### Inherited By

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

---

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)