---
title: "End-date Account billing entities"
method: PUT
path: "/organizations/{orgId}/accounts/{id}/enddatebillingentities"
tags: ["Account"]
---

# End-date Account billing entities

`PUT /organizations/{orgId}/accounts/{id}/enddatebillingentities`

Apply the specified end-date to billing entities associated with an Account.

**NOTE:**
- When you successfully end-date billing entities, the version number of each entity is incremented.

## Path parameters

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

## Request body

- EndDateBillingEntitiesRequest
  - `endDate` string, date-time, required — The end date and time applied to the specified billing entities *(in ISO 8601 format)*.
  - `applyToChildren` boolean — A Boolean TRUE/FALSE flag. For Parent Accounts, set to TRUE if you want the specified end-date to be applied to any billing entities associated with Child Accounts. *(Optional)*
  - `billingEntities` BillingEntity[], required — Defines which billing entities associated with the Account will have the specified end-date applied. For example, if you want the specified end-date to be applied to all Prepayments/Commitments created for the Account use `"PREPAYMENT"`.

## Response `200`

Return the status and details of the updated active billing entities.

- EndDateBillingEntitiesResponse
  - `statusMessage` string — A message indicating the status of the operation.
  - `updatedEntities` object — A dictionary with keys as identifiers of billing entities and values as lists containing details of the updated entities.
    - `CONTRACT` SetString
      - `empty` boolean
    - `ACCOUNTPLAN` SetString
      - `empty` boolean
    - `PREPAYMENT` SetString
      - `empty` boolean
    - `PRICINGS` SetString
      - `empty` boolean
    - `COUNTER_PRICINGS` SetString
      - `empty` boolean
  - `failedEntities` object — A dictionary with keys as identifiers of billing entities and values as lists containing details of the entities for which the update failed.
    - `CONTRACT` SetString
      - `empty` boolean
    - `ACCOUNTPLAN` SetString
      - `empty` boolean
    - `PREPAYMENT` SetString
      - `empty` boolean
    - `PRICINGS` SetString
      - `empty` boolean
    - `COUNTER_PRICINGS` SetString
      - `empty` boolean

## 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)
