• Example searches: “transaction”, “CreateOrder”, “/v2/locations”, “inventory”, “delete customer”

You are viewing an old version of the API
Delete invoice

DELETE /v2/invoices/{invoice_id}

Deletes the specified invoice.

When an invoice is deleted, the associated order status changes to CANCELED. You can only delete a draft invoice (you cannot delete a published invoice, including one that is scheduled for processing).

Permissions
ORDERS_WRITE
INVOICES_WRITE
Guide
Delete invoices Try in API Explorer

Path Parameters

Example code
Name Description
invoice_id
string
Required

The ID of the invoice to delete.

Query Parameters
Name Description
version
integer (32-bit)

The version of the invoice to delete. If you do not know the version, you can call GetInvoice or ListInvoices.

Response Fields
Name Description
errors
Error [ ]

Information about errors encountered during the request.

Examples

You are viewing an old version of the API
DELETE /v2/invoices/{invoice_id}
cURL
  • cURL
  • Ruby
  • Python
  • C#
  • Java
  • PHP
  • Node.js 
curl https://connect.squareup.com/v2/invoices/invoice_id0 \
  -X DELETE \
  -H 'Square-Version: 2023-03-15' \
  -H 'Authorization: Bearer ACCESS_TOKEN' \
  -H 'Content-Type: application/json'
Response JSON 
{}