---
title: "Delete BalanceChargeSchedule"
method: DELETE
path: "/organizations/{orgId}/balances/{balanceId}/balancechargeschedules/{id}"
tags: ["BalanceChargeSchedule"]
---

# Delete BalanceChargeSchedule

`DELETE /organizations/{orgId}/balances/{balanceId}/balancechargeschedules/{id}`

Delete the BalanceChargeSchedule for the given UUID.

## Path parameters

- `orgId` string, required
- `balanceId` string, required
- `id` string, required

## Response `200`

Return the deleted BalanceChargeSchedule

- BalanceChargeScheduleResponse
  - `id` string, required — The UUID of the entity.
  - `version` integer — The version number: - **Create:** On initial Create to insert a new entity, the version is set at 1 in the response. - **Update:** On successful Update, the version is incremented by 1 in the response.
  - `customFields` object — User defined fields enabling you to attach custom data. The value for a custom field can be either a string or a number. If `customFields` can also be defined for this entity at the Organizational level,`customField` values defined at individual level override values of `customFields` with the same name defined at Organization level. See [Working with Custom Fields](https://www.m3ter.com/docs/guides/creating-and-managing-products/working-with-custom-fields) in the m3ter documentation for more information.
  - `balanceId` string — The unique identifier (UUID) for the Balance this Balance Charge Schedule was created for.
  - `name` string — The name of the Balance Charge Schedule.
  - `code` string — Unique short code for the Balance Charge Schedule.
  - `amount` number — The amount of each Charge created by the Balance Charge Schedule.
  - `units` number — Number of units. If the Charge was created with `amount` only, then will be null.
  - `unitPrice` number — Unit price. If the Charge was created with `amount` only, then will be null.
  - `currency` string — The currency of the Charges created by the Balance Charge Schedule.
  - `servicePeriodStartDate` string, date-time — The service period start date (*in ISO-8601 format*) of the Balance Charge Schedule.
  - `servicePeriodEndDate` string, date-time — The service period end date (*in ISO-8601 format*) of the Balance Charge Schedule.
  - `billEpoch` string, date — Specifies a billing cycle date (*in ISO-8601 format*) for when the first Bill is generated for Balance Charges created by the Schedule, and also acts as a reference for when in the Schedule period subsequent Bills are created for the defined `billFrequency`. If blank, then the relevant Epoch date from your Organization's configuration is used.
  - `billFrequency` 'DAILY' | 'WEEKLY' | 'MONTHLY' | 'ANNUALLY' — The period length of the Scheduled Balance Charge
  - `billFrequencyInterval` integer — How often Bills are issued. For example, if billFrequency is `MONTHLY` and `billFrequencyInterval` is 3, Bills are issued every three months.
  - `billInAdvance` boolean — Specifies how Charges created by the Balance Charge Schedule are billed - either in arrears or in advance: * If `false` then billing is in arrears. * If `true` then billing is in advance.
  - `chargeDescription` string, required — The description for Charges created by the Balance Charge Schedule. Used on Bills for Charge line items.
  - `dtCreated` string, date-time — The date and time (*in ISO-8601 format*) when the Balance Charge Schedule was created.
  - `dtLastModified` string, date-time — The date and time (*in ISO-8601 format*) when the Balance Charge Schedule was last modified.
  - `createdBy` string — The unique identifier (UUID) of the user who created the Balance Charge Schedule.
  - `lastModifiedBy` string — The unique identifier (UUID) for the user who last modified the Balance Charge Schedule.
  - `nextRun` string, date-time — The date and time (*in ISO-8601 format*) when the next Charge will be created by the Balance Charge Schedule.
  - `previousRun` string, date-time — The date and time (*in ISO-8601 format*) when the previous Charge was generated by the Balance Charge Schedule.

## Other responses

- `4XX` — Error message
- `5XX` — Error message

---

[API](https://skmtc.net/m3ter-com/apis/m3ter-api.md) · [All operations](https://skmtc.net/m3ter-com/apis/m3ter-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/m3ter-com/m3ter-api/versions/ac93d1a9e6d9/schema)