DELETE /api/v3/account/{accountId}

Permanently deletes an account, with an option to cascade-delete all associated bills

DeleteAccountV3 Permissions: Accounts (Delete)
Use this endpoint to remove an account from the system. This is a destructive, irreversible operation. If the account has associated bills, you must set deleteBills=true to cascade the deletion to those bills, otherwise the operation will fail if bills exist. Also removes account-meter relationships, rate assignments, templates, alerts, and UDF values associated with the account.

Request Headers

Header Value Required Description
ECI-ApiKey string Yes Your API key. See Authentication.
Content-Type application/json Yes All requests must specify JSON content type.

Path Parameters

Name Description Type Required
accountId The unique numeric identifier of the account to delete integer (int32) Required

Query Parameters

Name Description Type Required
deleteBills When true, cascades deletion to all bills on meters associated with this account. When false, deletion fails if bills exist. boolean Optional

Responses

204 No Content The request succeeded. No content is returned in the response body.
404 Not Found The requested resource was not found. Verify the ID or path is correct.