v48

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-262621423.8 MB

Void an invoice

Voids an invoice by setting its amount to zero while keeping a record of it in QuickBooks. The void will fail if the invoice is currently in use or has any linked transactions that are in use.

post/quickbooks-desktop/invoices/{id}/void

Path parameters

idstring required

The QuickBooks-assigned unique identifier of the invoice to void.

Example:123ABC-1234567890

The QuickBooks-assigned unique identifier of the invoice to void.

Headers

Conductor-End-User-Idstring required

The ID of the End-User to receive this request.

Example:end_usr_1234567abcdefg

The ID of the End-User to receive this request.

Response

Returns a confirmation of the void with the ID of the voided invoice.

idstring required

The QuickBooks-assigned unique identifier of the voided invoice.

objectType'qbd_invoice' required

The type of object. This value is always "qbd_invoice".

createdAtstring nullable required

The date and time when this invoice was created, in ISO 8601 format (YYYY-MM-DDThh:mm:ss+hh:mm), which QuickBooks Desktop interprets in the local timezone of the end-user's computer.

updatedAtstring nullable required

The date and time when this invoice was last updated, in ISO 8601 format (YYYY-MM-DDThh:mm:ss+hh:mm), which QuickBooks Desktop interprets in the local timezone of the end-user's computer.

refNumberstring nullable required

The case-sensitive user-defined reference number of the voided invoice.

voidedboolean required

Indicates whether the invoice was voided.

Example response

{
  "id": "123ABC-1234567890",
  "objectType": "qbd_invoice",
  "createdAt": "2025-01-01T12:34:56+00:00",
  "updatedAt": "2025-02-01T12:34:56+00:00",
  "refNumber": "INV-1234",
  "voided": true
}