# The Billing Cadence object

### The Billing Cadence object

```json
{
  "id": "bc_test_61Rc0IonJY96mpyHA16RM8VQESSQ4t1K5KYFAmKUSCie",
  "object": "v2.billing.cadence",
  "payer": {
    "type": "customer",
    "billing_profile": "bilp_test_61Rc0IonJY96mpyHA16RM8VQ",
    "customer": "cus_61Rc0HZtJCE9h"
  },
  "billing_cycle": {
    "type": "month",
    "interval_count": 1,
    "month": {
      "day_of_month": 3
    }
  },
  "metadata": {},
  "status": "active",
  "next_billing_date": "2025-01-03T00:00:00.000Z",
  "test_clock": "clock_1QScHiH5wvQ9UC0VklUiPqw4",
  "created": "2024-11-26T16:33:03.000Z",
  "livemode": false
}
```

## Attributes

- `id` (string)
  Unique identifier for the object.

- `object` (string, value is "v2.billing.cadence")
  String representing the object’s type. Objects of the same type share the same value of the object field.

- [`billing_cycle`](https://docs.stripe.com/api/v2/billing-cadences/cadences/object.md?query=billing_cycle) (object)
  The billing cycle is the object that defines future billing cycle dates.

- `created` (timestamp)
  Timestamp of when the object was created.

- `livemode` (boolean)
  Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.

- `lookup_key` (string, nullable)
  A lookup key used to retrieve cadences dynamically from a static string. Maximum length of 200 characters.

- `metadata` (map, nullable)
  Set of [key-value pairs](https://docs.stripe.com/api/metadata.md) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.

- `next_billing_date` (timestamp, nullable)
  The date that the billing cadence will next bill. Null if the cadence is not active.

- [`payer`](https://docs.stripe.com/api/v2/billing-cadences/cadences/object.md?query=payer) (object)
  The payer determines the entity financially responsible for the bill.

- `settings_data` (object, nullable)
  Settings data that contains expanded billing settings configuration with actual values.

- `status` (enum)
  The current status of the cadence.
Possible enum values:
  - `active`
    The cadence is active and can have subscriptions associated.

  - `canceled`
    The cadence is no longer generating invoices and has been canceled.

- `test_clock` (string, nullable)
  The ID of the Test Clock.