---
title: "Update Charge"
method: PUT
path: "/organizations/{orgId}/charges/{id}"
tags: ["Charge"]
---

# Update Charge

`PUT /organizations/{orgId}/charges/{id}`

Update a Charge for the given UUID.

**NOTE:** When you update a Charge on an Account, you can provide either a Charge `amount` or Charge `units` together with a `unitPrice`, but *not both*.

## Path parameters

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

## Request body

- ChargeRequest — Request containing a Charge entity
  - `version` integer — The version number of the entity: - **Create entity:** Not valid for initial insertion of new entity - *do not use for Create*. On initial Create, version is set at 1 and listed in the response. - **Update Entity:** On Update, version is required and must match the existing version because a check is performed to ensure sequential versioning is preserved. Version is incremented by 1 and listed in the response.
  - `name` string, required — Name of the Charge. Added to the Bill line item description for this Charge.
  - `code` string, required — Unique short code for the Charge.
  - `accountId` string, required — The ID of the Account the Charge is being created for.
  - `billDate` string — The date when the Charge will be added to a Bill.
  - `amount` number — Amount of the Charge. If `amount` is provided, then `units` and `unitPrice` must be omitted.
  - `units` number — Number of units of the Charge. If `amount` is omitted, then provide together with `unitPrice`. When `amount` is provided, `units` must be omitted.
  - `unitPrice` number — Unit price. If `amount` is omitted, then provide together with `units`. When `amount` is provided, `unitPrice` must be omitted.
  - `currency` string, required — Charge currency.
  - `description` string — The description added to the Bill line item for the Charge.
  - `entityType` 'AD_HOC' | 'BALANCE', required — The entity this charge is created for, ex: Balance or AD_HOC if none applies
  - `lineItemType` 'BALANCE_FEE' | 'AD_HOC', required — The Line Item Type to be used for this Charge
  - `entityId` string — The ID of the Charge linked entity. For example, the ID of an Account Balance if a Balance Charge. **NOTE:** If `entityType` is `BALANCE`, you must provide the `entityId` of the Balance the Charge is for.
  - `accountingProductId` string — The Accounting Product ID assigned to the Charge.
  - `servicePeriodStartDate` string, date-time, required — The service period start date (*in ISO-8601 format*) for the Charge.
  - `servicePeriodEndDate` string, date-time, required — The service period end date (*in ISO-8601 format*)for the Charge. **NOTE:** End date is exclusive.
  - `notes` string — Used to enter information about the Charge for accounting purposes, such as the reason it was created. This information will not be added to a Bill line item for the Charge.
  - `contractId` string — The ID of a Contract on the Account that the Charge will be added to.

## Response `200`

Returns the updated Charge

- ChargeResponse
  - `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.

## 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/revisions/ac93d1a9e6d9/schema)