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


@protocol INSearchCallHistoryIntentHandling


Use the methods of the 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 is capable of performing the search and finding any matching records. Siri does not display the call information found during the search. After a successful search, Siri launches your app to display that information.

Siri delivers an 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.


Resolving the Intent Parameters

- resolveCallTypesForSearchCallHistory:withCompletion:

Resolves the search criteria for the call type.

- resolveCallTypeForSearchCallHistory:withCompletion:

Resolves the search criteria for the call type.

- resolveRecipientForSearchCallHistory:withCompletion:

Resolves the search criteria for the recipients.

- resolveDateCreatedForSearchCallHistory:withCompletion:

Resolves the range of dates for the search.

- resolveUnseenForSearchCallHistory:withCompletion:

Resolves whether you can search for calls that the user has not yet seen.

Confirming the Response

- confirmSearchCallHistory:completion:

Confirms that you can perform the search.

Handling the Intent

- handleSearchCallHistory:completion:

Handles searching the user’s call history.



Inherits From

See Also

Search the Call History


A request to list the calls matching the specified criteria.


Your app’s response to a search call history intent.