<!--
{
  "availability" : [
    "iOS: 10.3.0 - 15.0.0",
    "iPadOS: 10.3.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/INSearchForBillsIntent",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "Intents"
    ],
    "preciseIdentifier" : "c:objc(cs)INSearchForBillsIntent"
  },
  "title" : "INSearchForBillsIntent"
}
-->

# INSearchForBillsIntent

A request for the list of bills matching the specified criteria.

```
class INSearchForBillsIntent
```

## Overview

Siri creates an [`INSearchForBillsIntent`](/documentation/Intents/INSearchForBillsIntent) object when the user asks to see pending or already paid bills. The intent object contains the values to match when searching for bills. Users can search for bills based on the due date, the payee, the type, and whether they’re pending or already paid. When performing the search, use only the provided parameters to filter the search results and ignore any parameters that have a missing or unknown value.

To handle this intent, the handler object in your Intents extension must adopt the [`INSearchForBillsIntentHandling`](/documentation/Intents/INSearchForBillsIntentHandling) protocol. Your handler should confirm the request and create an [`INSearchForBillsIntentResponse`](/documentation/Intents/INSearchForBillsIntentResponse) object with the results of the search. For successful searches, Siri offers a way for the user to view 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         |

When performing a search, Siri automatically asks the user to unlock a currently locked device. You don’t need to explicitly ask to unlock the device.

## Topics

### Initializing the Intent Object

[`init(billPayee: INBillPayee?, paymentDateRange: INDateComponentsRange?, billType: INBillType, status: INPaymentStatus, dueDateRange: INDateComponentsRange?)`](/documentation/Intents/INSearchForBillsIntent/init(billPayee:paymentDateRange:billType:status:dueDateRange:))

Initializes an intent object that describes a search for bill details with the specified search parameters.

### Getting the Search Attributes

[`var billPayee: INBillPayee?`](/documentation/Intents/INSearchForBillsIntent/billPayee)

The recipient of the payment.

[`var billType: INBillType`](/documentation/Intents/INSearchForBillsIntent/billType)

The type of the bill.

[`var dueDateRange: INDateComponentsRange?`](/documentation/Intents/INSearchForBillsIntent/dueDateRange)

The range of due dates in which to search for bills.

[`var paymentDateRange: INDateComponentsRange?`](/documentation/Intents/INSearchForBillsIntent/paymentDateRange)

The range of payment dates in which to search for bills.

[`var status: INPaymentStatus`](/documentation/Intents/INSearchForBillsIntent/status)

The status of the bill.

## Relationships

### Conforms To

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

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

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

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

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

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

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

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

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

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

### 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)