Cancel invoice

POST https://api.invunion.com/api/v1/invoices/:code/cancel invoices:write Idempotency-Key Markdown

Cancel an invoice that has not been settled.

Sets status to cancelled. Refused when live matches, credit-note allocations, or a non-zero settled_amount exist. Already cancelled invoices return 200 without changing the row. Identify the invoice with its invoice_number.

Path parameters

Name Type Required

code

Invoice number (invoice_number). Invoices without a number cannot be addressed by path.

Example: INV-2026-0042

string

Max 100

Required

Errors

This operation can return the following errors in addition to generic HTTP failures.

Error	HTTP code	Description
`Missing Bearer token`	401	The Authorization header is missing or is not a Bearer token.
`Invalid or revoked API key`	401	The API key is unknown, malformed, expired, or has been revoked.
`API key is missing scope invoices:write`	403	The key does not include invoices:write. A write scope does not imply the matching read scope.
`Too many requests, please try again later`	429	More than 100 requests in one minute from this API key or IP address. Wait for the Retry-After header (seconds) and retry.
`Tenant ID required`	400	The authenticated credential is not bound to a tenant.
`Invoice not found`	404	No invoice with this number exists in the authenticated tenant.
`This invoice has received payments or credit-note allocations. Unlink them or issue a credit note instead of cancelling.`	409	Live matches, allocations, or settled_amount prevent cancel.
`Internal server error`	500	Unexpected server error. The JSON body includes correlationId. Retry with backoff.
`Idempotency-Key must be 8-255 characters: letters, digits, ".", "_", ":" or "-".`	400	The Idempotency-Key header is present but malformed.
`A request with this Idempotency-Key is still being processed.`	409	The first request with this key has not finished. Retry after it completes. code is idempotency_in_progress.
`This Idempotency-Key was already used with a different request body.`	422	Send a new key for a different request. code is idempotency_key_reuse.

Previous: Create invoice Next: Overview

Request

Requests in the examples call https://api.invunion.com/api/v1/invoices/INV-2026-0042/cancel.

curl --request POST \
  --url https://api.invunion.com/api/v1/invoices/INV-2026-0042/cancel \
  --header 'accept: application/json' \
  --header 'authorization: Bearer uk_live_YOUR_API_KEY'

import requests

url = "https://api.invunion.com/api/v1/invoices/INV-2026-0042/cancel"
headers = {
    "Accept": "application/json",
    "Authorization": "Bearer uk_live_YOUR_API_KEY",
}
response = requests.post(url, headers=headers)
print(response.json())

require 'net/http'
require 'json'
require 'uri'

uri = URI("https://api.invunion.com/api/v1/invoices/INV-2026-0042/cancel")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Post.new(uri)
request['Accept'] = 'application/json'
request['Authorization'] = 'Bearer uk_live_YOUR_API_KEY'
response = http.request(request)
puts response.body

const response = await fetch("https://api.invunion.com/api/v1/invoices/INV-2026-0042/cancel", {
  method: "POST",
  headers: {
    "Accept": "application/json",
    "Authorization": "Bearer uk_live_YOUR_API_KEY"
  },
});
const data = await response.json();

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, err := http.NewRequest("POST", "https://api.invunion.com/api/v1/invoices/INV-2026-0042/cancel", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Accept", "application/json")
	req.Header.Set("Authorization", "Bearer uk_live_YOUR_API_KEY")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

const response = await fetch("https://api.invunion.com/api/v1/invoices/INV-2026-0042/cancel", {
  method: "POST",
  headers: {
    "Accept": "application/json",
    "Authorization": "Bearer uk_live_YOUR_API_KEY"
  },
});
console.log(await response.json());

200

{
  "success": true,
  "data": {
    "id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
    "tenant_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "counterparty_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "invoice_number": "INV-2026-0042",
    "kind": "invoice",
    "invoice_type": "issued",
    "status": "cancelled",
    "currency": "EUR",
    "amount_excl_vat": 10000,
    "vat_amount": 2000,
    "amount_incl_vat": 12000,
    "settled_amount": 0,
    "open_amount": 12000,
    "recovery_percent": 0,
    "invoice_date": "2026-09-01T00:00:00.000Z",
    "due_date": "2026-10-01T00:00:00.000Z",
    "payment_expected_date": "2026-10-01T00:00:00.000Z",
    "payment_term_days": null,
    "recipient_name": "Leones Cars",
    "customer_name": "Leones Cars",
    "description": "Fleet maintenance — September 2026",
    "external_reference": "LC-SO-9081",
    "counterparty_name_display": "Leones Cars",
    "is_overdue": false,
    "next_due_date": "2026-10-01",
    "created_at": "2026-09-01T10:00:00.000Z",
    "updated_at": "2026-09-12T09:00:00.000Z",
    "settlement_status": "cancelled",
    "installments": [
      {
        "sequence": 1,
        "label": null,
        "dueDate": "2026-10-01",
        "expectedPaymentDate": "2026-10-01",
        "amount": 12000,
        "source": "default",
        "settledAmount": 0,
        "openAmount": 12000,
        "status": "cancelled",
        "isOverdue": false
      }
    ]
  }
}