---
title: "Delete an invoice"
method: DELETE
path: "/v1/invoices/{invoiceKey}"
tags: ["Invoices"]
---

# Delete an invoice

`DELETE /v1/invoices/{invoiceKey}`

Deletes a specific invoice.

Whether to delete an invoice synchronously or asynchronously depends on the number of invoice items contained in the invoice. By default, if an invoice contains less than 100 items, the invoice is deleted synchronously. Otherwise, the invoice is deleted asynchronously. If you want to change the threshold, submit a request at <a href="http://support.zuora.com/" target="_blank">Zuora Global Support</a>.

## Path parameters

- `invoiceKey` 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

- DeleteInvoiceResponseType
  - `id` string — The ID of the deleted invoice.
  - `jobId` string — The ID of the job that handles the invoice 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' | 'Completed' — The status of the invoice 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)