<!--
{
  "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/INSearchCallHistoryIntentResponse",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "Intents"
    ],
    "preciseIdentifier" : "c:objc(cs)INSearchCallHistoryIntentResponse"
  },
  "title" : "INSearchCallHistoryIntentResponse"
}
-->

# INSearchCallHistoryIntentResponse

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

```
class INSearchCallHistoryIntentResponse
```

## Overview

Use an [`INSearchCallHistoryIntentResponse`](/documentation/Intents/INSearchCallHistoryIntentResponse) object to specify the results of searching the user’s call history. After performing a search using the criteria specified in the [`INSearchCallHistoryIntent`](/documentation/Intents/INSearchCallHistoryIntent) object, create an instance of this class with the results of that search.

Your app is responsible for displaying the results of your search, so you must communicate the results to it. One way to communicate those results is through the <doc://com.apple.documentation/documentation/Foundation/NSUserActivity> object that you create with your response. After creating that object, place the results in its <doc://com.apple.documentation/documentation/Foundation/NSUserActivity/userInfo> dictionary.

You create an [`INSearchCallHistoryIntentResponse`](/documentation/Intents/INSearchCallHistoryIntentResponse) object in the [`confirm(intent:completion:)`](/documentation/Intents/INSearchCallHistoryIntentHandling/confirm(intent:completion:)) and [`handle(intent:completion:)`](/documentation/Intents/INSearchCallHistoryIntentHandling/handle(intent:completion:)) methods of your search call history handler object. For more information about implementing your handler object, see [`INSearchCallHistoryIntentHandling`](/documentation/Intents/INSearchCallHistoryIntentHandling).

## Topics

### Initializing the Response Object

[`init(code:userActivity:)`](/documentation/Intents/INSearchCallHistoryIntentResponse/init(code:userActivity:))

Initializes the response object with the specified code and user activity object.

### Getting the Response Code

[`code`](/documentation/Intents/INSearchCallHistoryIntentResponse/code)

The code indicating whether you successfully handled the intent.

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

Constants indicating the status of the response.

### Providing the Search Results

[`callRecords`](/documentation/Intents/INSearchCallHistoryIntentResponse/callRecords)

An array of call records representing the results of the 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)