---
title: SubscriptionBillingCycleBulkFilters - GraphQL Admin
description: The input fields for filtering subscription billing cycles in bulk actions.
api_version: 2024-10
api_name: admin
type: input_object
api_type: graphql
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/2024-10/input-objects/SubscriptionBillingCycleBulkFilters
  md: >-
    https://shopify.dev/docs/api/admin-graphql/2024-10/input-objects/SubscriptionBillingCycleBulkFilters.txt
---

# Subscription​Billing​Cycle​Bulk​Filters

input\_object

The input fields for filtering subscription billing cycles in bulk actions.

## Fields

* billing​Attempt​Status

  [Subscription​Billing​Cycle​Billing​Attempt​Status](https://shopify.dev/docs/api/admin-graphql/2024-10/enums/SubscriptionBillingCycleBillingAttemptStatus)

  Default:ANY

  Filters the billing cycles based on the presence of billing attempts.

* billing​Cycle​Status

  [\[Subscription​Billing​Cycle​Billing​Cycle​Status!\]](https://shopify.dev/docs/api/admin-graphql/2024-10/enums/SubscriptionBillingCycleBillingCycleStatus)

  Filters the billing cycles based on their status.

* contract​Status

  [\[Subscription​Contract​Subscription​Status!\]](https://shopify.dev/docs/api/admin-graphql/2024-10/enums/SubscriptionContractSubscriptionStatus)

  Filters the billing cycles based on the status of their associated subscription contracts.

***

## Mutations using this input

* [subscription​Billing​Cycle​Bulk​Charge.​filters](https://shopify.dev/docs/api/admin-graphql/2024-10/mutations/subscriptionBillingCycleBulkCharge#argument-filters)

  MUTATION

* [subscription​Billing​Cycle​Bulk​Search.​filters](https://shopify.dev/docs/api/admin-graphql/2024-10/mutations/subscriptionBillingCycleBulkSearch#argument-filters)

  MUTATION

***

## Map

### Mutations using this input

* <\~>[subscription​Billing​Cycle​Bulk​Charge.filters](https://shopify.dev/docs/api/admin-graphql/2024-10/mutations/subscriptionBillingCycleBulkCharge#argument-filters)
* <\~>[subscription​Billing​Cycle​Bulk​Search.filters](https://shopify.dev/docs/api/admin-graphql/2024-10/mutations/subscriptionBillingCycleBulkSearch#argument-filters)