# recurringBillingSubscriptions

Query · GraphQL API

A paginated list of recurring billing subscriptions that match the RecurringBillingSubscriptionSearchInput.

## Authentication

- SERVER

## Input

- `input` (`RecurringBillingSubscriptionSearchInput!`) — required
- `first` (`Int`)
- `after` (`String`)

## Returns [RecurringBillingSubscriptionConnection](/braintree/graphql/reference/types/recurring-billing-subscription-connection)

A paginated list of recurring billing subscriptions.

### Returned fields

- `edges` (`[RecurringBillingSubscriptionConnectionEdge]`): A list of recurring billing subscriptions.
- `pageInfo` (`PageInfo!`) — non-null: Information about the page of recurring billing subscriptions contained in `edges`.

## Examples

### Search recurring billing subscriptions

A paginated list of recurring billing subscriptions that match the RecurringBillingSubscriptionSearchInput.

```graphql
query searchRecurringBillingSubscriptions($input: RecurringBillingSubscriptionSearchInput!, $first: Int, $after: String)  {
  recurringBillingSubscriptions(input: $input, first: $first, after: $after) {
    edges {
      cursor
      node {
        __typename
        id
        legacyId
        payPalDescription
        status
        price
        balance
        billingDayOfMonth
        currentBillingCycle
        numberOfBillingCycles
        failureCount
        daysPastDue
        timeline {
          firstBillingDate
          nextBillingDate
          billingPeriodStartDate
          billingPeriodEndDate
          paidThroughDate
          createdAt
          updatedAt
        }
        nextBillingPeriodAmount
        trial {
          duration
          durationUnit
        }
        descriptor {
          companyName
          phoneNumber
          url
        }
        planId
        paymentMethodId
        merchantAccountId
        addOns {
          amount
          quantity
          currentBillingCycle
          numberOfBillingCycles
          addOnId
        }
        discounts {
          amount
          quantity
          currentBillingCycle
          numberOfBillingCycles
          discountId
        }
        transactionIds
        statusHistory {
          status
          balance
          price
          subscriptionSource
          timestamp
          planId
          currencyIsoCode
        }
      }
    }
    pageInfo {
      hasNextPage
      hasPreviousPage
      startCursor
      endCursor
    }
  }
}
```

---

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