Skip to content

Delete invoice

DELETE/documents/invoices/{id}

Costs 2 rate-limit points · Rate limits

Moves an invoice to the trash, as the Invoices page does: it leaves the lists, keeps its number and PDF, and can be restored. Nothing is deleted permanently and Shopify is not touched.

Reversible with POST /documents/invoices/:id/restore. Trashed invoices are still returned by GET /documents/invoices?link=trashed. Trashing does not free the invoice number: opening the order shows the same invoice again. To free a number taken by mistake, use DELETE /documents/invoices/:id/permanent.

Also searched astrash invoicedelete invoiceremove invoicemove invoice to trashhide invoicediscard invoice

Path parameters

  • idstringRequired

Returns

  • idinteger
    Example: 980190991
  • trashedboolean
    Example: true

Errors

401

Missing or unknown X-Auth-Token, or the shop uninstalled the app.

403

v3_required: the shop still runs the previous dashboard. paid_plan_required: API access needs a paid plan.

404

The resource does not exist for this shop, or no action is registered at this path.

422

The request failed validation. Nothing was saved.

429

Rate limited: cost-weighted per key (reads cost less than writes). Wait Retry-After seconds; see X-RateLimit-* headers.

Every error has the same shape: see Errors.

DELETE/documents/invoices/{id}
curl -X DELETE "https://app.invoicefalcon.com/api/v3/external/documents/invoices/980191059" \
  -H "X-Auth-Token: $INVOICE_FALCON_API_KEY"
Response
{
  "id": 980190991,
  "trashed": true
}