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

# 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/latest/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/latest/enums/SubscriptionBillingCycleBillingCycleStatus)

  Filters the billing cycles based on their status.

* contract​Status

  [\[Subscription​Contract​Subscription​Status!\]](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/mutations/subscriptionBillingCycleBulkCharge#arguments-filters)

  ARGUMENT

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

  ARGUMENT

***

## Map

### Mutations using this input

* [subscription​Billing​Cycle​Bulk​Charge.filters](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionBillingCycleBulkCharge#arguments-filters)
* [subscription​Billing​Cycle​Bulk​Search.filters](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionBillingCycleBulkSearch#arguments-filters)