<!--
{
  "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" : "Intents",
  "identifier" : "/documentation/Intents/INSearchForBillsIntentHandling",
  "metadataVersion" : "0.1.0",
  "role" : "Protocol",
  "symbol" : {
    "kind" : "Protocol",
    "modules" : [
      "Intents"
    ],
    "preciseIdentifier" : "c:objc(pl)INSearchForBillsIntentHandling"
  },
  "title" : "INSearchForBillsIntentHandling"
}
-->

# INSearchForBillsIntentHandling

The handler interface for searching for bills associated with the user.

```
protocol INSearchForBillsIntentHandling : NSObjectProtocol
```

## Overview

Use the methods of the [`INSearchForBillsIntentHandling`](/documentation/Intents/INSearchForBillsIntentHandling) protocol to resolve, confirm, and handle requests to search for bills related to the user. Adopt this protocol in an object of your Intents extension that’s capable of searching the user’s bills and returning those bills that match the specified criteria. Users can search for bills based on the payee, the bill type, the due date, and whether the user has paid them or not.

Siri delivers an [`INSearchForBillsIntent`](/documentation/Intents/INSearchForBillsIntent) object to your handler when the user asks to search for bills using your app. The provided intent object contains the parameters to use during the search. Use the methods of this protocol to resolve the parameters and perform the search.

## Topics

### Resolving the Intent Parameters

[`func resolveBillPayee(for: INSearchForBillsIntent, with: (INBillPayeeResolutionResult) -> Void)`](/documentation/Intents/INSearchForBillsIntentHandling/resolveBillPayee(for:with:))

Resolves the payee to use during your search.

[`func resolveBillType(for: INSearchForBillsIntent, with: (INBillTypeResolutionResult) -> Void)`](/documentation/Intents/INSearchForBillsIntentHandling/resolveBillType(for:with:))

Resolves the bill type to use during your search.

[`func resolveDueDateRange(for: INSearchForBillsIntent, with: (INDateComponentsRangeResolutionResult) -> Void)`](/documentation/Intents/INSearchForBillsIntentHandling/resolveDueDateRange(for:with:))

Resolves the due date to use during your search.

[`func resolvePaymentDateRange(for: INSearchForBillsIntent, with: (INDateComponentsRangeResolutionResult) -> Void)`](/documentation/Intents/INSearchForBillsIntentHandling/resolvePaymentDateRange(for:with:))

Resolves the payment date to use during your search.

[`func resolveStatus(for: INSearchForBillsIntent, with: (INPaymentStatusResolutionResult) -> Void)`](/documentation/Intents/INSearchForBillsIntentHandling/resolveStatus(for:with:))

Resolves the bill status to use during your search.

### Confirming the Response

[`func confirm(intent: INSearchForBillsIntent, completion: (INSearchForBillsIntentResponse) -> Void)`](/documentation/Intents/INSearchForBillsIntentHandling/confirm(intent:completion:))

Confirms whether you can perform the search.

### Handling the Intent

[`func handle(intent: INSearchForBillsIntent, completion: (INSearchForBillsIntentResponse) -> Void)`](/documentation/Intents/INSearchForBillsIntentHandling/handle(intent:completion:))

Handles searching for the specified bills.

## Relationships

### Inherits From

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

### Inherited By

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

---

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)