Update or Delete Invoice
Table of Contents
Update a current invoice or deactivate it. The API key user needs invoice editing permission. Changes that affect paid or partially paid status can require payment permissions as well. Check allowed_statuses and can_delete on the invoice returned by Get Invoice.
POST /invoices/{invoice_id}
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
invoice_id |
string | Yes | QReserve ID of the invoice. |
Update an Invoice
Send the fields you want to change. These are common fields.
| Parameter | Type | Required | Description |
|---|---|---|---|
bill_to_user_id |
string or null | No | Set the billed user. Use null to clear the billed user. |
bill_to_name, bill_to_email, bill_to_address |
string | No | Invoice recipient details. |
bill_to_account_number, purchase_order_number |
string | No | Account and purchase order references. |
invoice_name, invoice_address |
string | No | Issuer details displayed on the invoice. |
invoice_number, invoice_number_prefix |
string | No | Invoice number and prefix. |
invoice_date, due_date |
string | No | Invoice and due dates (YYYY-MM-DD). |
billing_period_start, billing_period_end |
string | No | Billing period dates (YYYY-MM-DD). |
memo, payment_instructions, internal_note |
string | No | Invoice text, payment instructions, or internal note. |
status |
string | No | New invoice or quote status. Use an allowed transition for the current invoice. |
status_detail |
string | No | Additional status information. |
currency_code |
string | No | Currency code such as CAD. |
per_item_tax |
boolean | No | Calculate tax per line item. |
items |
array of objects | No | The complete line-item list, ordered by each itemβs integer position. |
If you include items, send every line item you want to retain, with its current invoice_item_id and field values. Omitted line items are removed. For a new line item, omit invoice_item_id and provide position and the applicable fields, such as item, description, sku, units, and unit_rate. Use decimal strings such as "25.00" for unit rates. Omit items entirely to leave line items as they are.
Example Update
curl -X POST 'https://api.qreserve.com/invoices/INVOICE_ID' \
-H 'Authorization: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"due_date":"2026-11-30","purchase_order_number":"PO-1042"}'
Delete an Invoice
Send {"delete": true}. QReserve deactivates the invoice. Deleting an invoice with a successful payment requires payment void permission. Deleting an invoice marked paid or partially paid also requires payment recording permission.
curl -X POST 'https://api.qreserve.com/invoices/INVOICE_ID' \
-H 'Authorization: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"delete":true}'
Response
An update returns the current invoice in data. A delete returns a success response without an invoice object. If the API rejects a stale invoice version, retrieve the invoice again before retrying the change.
{
"status": "success",
"data": {
"invoice_id": "INVOICE_ID",
"due_date": "2026-11-30",
"purchase_order_number": "PO-1042"
}
}
See the Invoices API overview for shared IDs and permissions.