---
title: "How to Change a Customer’s Bill Cycle"
slug: "how-to-change-a-customer-s-bill-cycle"
updated: 2026-06-02T21:20:26Z
published: 2026-06-02T21:20:26Z
canonical: "help.idibilling.com/how-to-change-a-customer-s-bill-cycle"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.idibilling.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How to Change a Customer’s Bill Cycle

To change a customer’s assigned bill cycle a bill cycle change request must be submitted. As part of this request the bill period the change will become effective on must be specified. Validation rules around when a bill cycle change is allowed can be found in the API documentation (see link below).

## Steps

1. ### Get Recommended Bill Periods

Before submitting a bill cycle change request, you must specify which bill period within the new cycle the change should become effective on. IDI provides a method which will return the recommended bill period per cycle. This will return a list of bill periods (one per bill cycle).

**Example:**

```plaintext
GET https://api.idibilling.com/CustomerManagement/2x/{environment}/api/customer/{id}/recommendedbillperiod
```

*Response:*

```plaintext
{
  "value": [
    {
      "billCycle": "Monthly on the 7th",
      "billCycleDescription": "Occurs monthly on the 7th",
      "billCycleID": 1234,
      "billingDate": "2017-08-07T09:00:00.1568626-05:00",
      "billPeriodID": 211170707,
      "endDate": "2017-08-07T09:00:00.0000000-05:00",
      "name": "211170707",
      "startDate": "2017-07-07T09:00:00.0000000-05:00"
    }
  ]
}
```
2. ### Create Bill Cycle Change Request

Once the recommended bill period id is obtained, use it when invoking the BillCycleChange operation, in the Customer Management web service, to put in the request.

**Example:**

```plaintext
POST https://api.idibilling.com/CustomerManagement/2x/{environment}/api/customer/{id}/billcyclechange
```

*Request body:*

```plaintext
{
  "newBillPeriodID": 31170707
}
```

*Response:*

```plaintext
{
  "billCycleChangeID": 777,
  "customerID": 1,
  "effectiveDate": "2017-08-07T09:00:00.1568626-05:00",
  "newBillCycleID": 2,
  "newBillPeriodID": 21170707,
  "oldBillCycleID": 3,
  "oldBillPeriodID": 31170303
}
```

## API documentation

[Customer Management API](https://support.idibilling.com/webapi/Customer%20Management%20API%20Documentation/)