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

# INSearchCallHistoryIntent

A request to list the calls matching the specified criteria.

```
class INSearchCallHistoryIntent
```

## Overview

SiriKit creates [`INSearchCallHistoryIntent`](/documentation/Intents/INSearchCallHistoryIntent) objects when the user asks to see previous calls from their call history. This intent object contains the values for you to match when searching the user’s call history. Users can search for calls involving a specific person, calls that occurred on specific dates, or calls that are of a specific type such as missed calls. When performing the search, use only the parameters provided and ignore any that have no values.

To handle this intent, the handler object in your Intents extension must adopt the [`INSearchCallHistoryIntentHandling`](/documentation/Intents/INSearchCallHistoryIntentHandling) protocol. Your handler confirms the request and creates an [`INSearchCallHistoryIntentResponse`](/documentation/Intents/INSearchCallHistoryIntentResponse) object with the results of the search. For successful searches, Siri offers the user a way to launch your app and see the results.

### Additional Intent Attributes

The following table lists additional attributes of this intent object:

|Attribute                      |Description |
|-------------------------------|------------|
|Supported by                   |Siri Intents|
|Always requires unlocked device|Yes         |

## Topics

### Initializing the Intent Object

[`init(dateCreated:recipient:callCapabilities:callTypes:unseen:)`](/documentation/Intents/INSearchCallHistoryIntent/init(dateCreated:recipient:callCapabilities:callTypes:unseen:))

Creates a search call history intent object with the specified search criteria.

[`-  initWithDateCreated:recipient:callCapabilities:callTypes:unseen:`](/documentation/Intents/INSearchCallHistoryIntent/initWithDateCreated:recipient:callCapabilities:callTypes:unseen:)

Initializes the search call history intent object with the specified search criteria.

[`init(callType:dateCreated:recipient:callCapabilities:)`](/documentation/Intents/INSearchCallHistoryIntent/init(callType:dateCreated:recipient:callCapabilities:))

Creates a search call history intent object with the specified search criteria.

### Getting the Recipient

[`recipient`](/documentation/Intents/INSearchCallHistoryIntent/recipient)

The person involved in the call.

### Getting the Call History Details

[`dateCreated`](/documentation/Intents/INSearchCallHistoryIntent/dateCreated)

The range of dates associated with the call records.

[`callTypes`](/documentation/Intents/INSearchCallHistoryIntent/callTypes)

The types of calls to search.

[`callType`](/documentation/Intents/INSearchCallHistoryIntent/callType)

The call type.

[`callCapabilities`](/documentation/Intents/INSearchCallHistoryIntent/callCapabilities)

The audio-video capabilities of the call.

[`unseen`](/documentation/Intents/INSearchCallHistoryIntent/unseen-9ua7o)

A Boolean value that indicates whether the user has seen the call yet.

[`unseen`](/documentation/Intents/INSearchCallHistoryIntent/unseen-1mohp)

A Boolean value that indicates whether the user has seen the call yet.

## Relationships

### Conforms To

[`NSCopying`](/documentation/Foundation/NSCopying)

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

[`NSCoding`](/documentation/Foundation/NSCoding)

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

[`Equatable`](/documentation/Swift/Equatable)

[`CustomDebugStringConvertible`](/documentation/Swift/CustomDebugStringConvertible)

[`CustomStringConvertible`](/documentation/Swift/CustomStringConvertible)

[`Hashable`](/documentation/Swift/Hashable)

[`CVarArg`](/documentation/Swift/CVarArg)

[`NSSecureCoding`](/documentation/Foundation/NSSecureCoding)

### Inherits From

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

---

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)