---
title: "Delete an account"
method: DELETE
path: "/v1/accounts/{account-key}"
tags: ["Accounts"]
---

# Delete an account

`DELETE /v1/accounts/{account-key}`

Deletes a specific account asynchronously. 

**Notes and Limitations:** 
- For account deletion, the system will start a backend job to remove all transactions under the accounts and change the status of the accounts to 'Cancelled'. This backend job is asynchronous and will take some time, depending on the job size.  
- An account cannot be deleted when the account is either the invoice owner or the subscription owner of a subscription and the subscription's invoice owner and subscription owner are two different accounts. An exception to this limitation is if the <a href="https://docs.zuora.com?resourceId=billing-default-subscription-and-order-settings" target="_blank">Enable Force Deletion for Account?</a> setting is set to `Yes`, you can force delete an account that is the subscription owner of a subscription while the invoice owner is a different account. Force deleting this account deletes all its subscriptions, but the relevant invoices will not be impacted.
- An account cannot be deleted if this account has ever been involved in an Owner Transfer amendment or order action, either as the current owner or as the previous owner.

## Path parameters

- `account-key` string, required

## Headers

- `Accept-Encoding` string
- `Content-Encoding` string
- `Zuora-Track-Id` string
- `Zuora-Entity-Ids` string
- `Zuora-Org-Ids` string
- `Zuora-Version` string

## Response `200`

OK

- DeleteAccountResponseType
  - `id` string — The ID of the deleted account.
  - `jobId` string — The ID of the job that handles the account deletion operation. You can specify the value of this field as the value of the `jobId` path parameter in the [Retrieve an operation job](https://developer.zuora.com/api-references/api/operation/GET_OperationJob/) API operation to query job information.
  - `jobStatus` 'Pending' — The status of the account deletion operation.
  - `reasons` object[]
    - `code` string — The error code of the response.
    - `message` string — The detail information of the error response.
  - `success` boolean — Whether the call succeeded.

## Other responses

- `500` — Internal Server Error
- `4XX` — Request Errors

---

[API](https://skmtc.dev/zuora/apis/api-reference.md) · [All operations](https://skmtc.dev/zuora/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zuora/api-reference/revisions/d11e237f3e54/schema)