# RecurringBillingSubscriptionSearchInput

Input · GraphQL API

Input fields for searching for recurring billing subscriptions.

## Fields

- `id` (`SearchValueInput`): Find subscriptions with a given ID or IDs.
- `planId` (`SearchTextValueInput`): Find subscriptions with a given plan ID or IDs.
- `status` (`[RecurringBillingSubscriptionStatus!]`): Find subscriptions with a given status.
- `merchantAccountId` (`SearchValueInput`): Find subscriptions with a given merchant account ID.
- `inTrialPeriod` (`Boolean`): Find subscriptions currently in a trial period.
- `transactionId` (`SearchTextInput`): Find subscriptions with a given transaction ID.
- `createdAt` (`SearchTimestampInput`): Find subscriptions created at a given time.
- `price` (`SearchRangeInput`): Find subscriptions with a given price.
- `daysPastDue` (`SearchRangeInput`): Find subscriptions with a given number of days past due.
- `billingCyclesRemaining` (`SearchRangeInput`): Find subscriptions with a given number of billing cycles remaining.
- `nextBillingDate` (`SearchDateInput`): Find subscriptions with a given next billing date.

## Used by

- [recurringBillingSubscriptions](/braintree/graphql/reference/queries/recurring-billing-subscriptions) — Query; input
- [Search](/braintree/graphql/reference/types/search) — Object; recurringBillingSubscriptions(input)

## GraphQL definition

```graphql
input RecurringBillingSubscriptionSearchInput {
  id: SearchValueInput
  planId: SearchTextValueInput
  status: [RecurringBillingSubscriptionStatus!]
  merchantAccountId: SearchValueInput
  inTrialPeriod: Boolean
  transactionId: SearchTextInput
  createdAt: SearchTimestampInput
  price: SearchRangeInput
  daysPastDue: SearchRangeInput
  billingCyclesRemaining: SearchRangeInput
  nextBillingDate: SearchDateInput
}
```

---

[View the complete GraphQL schema on GitHub](https://raw.githubusercontent.com/braintree/graphql-api/refs/heads/master/schema.graphql)