Delete draft invoice

DEL

/v1/invoices/{id}

Deletes a draft. Drafts have no invoice number, so nothing is missing from the numbering. A booked invoice cannot be deleted; credit it in Numina instead. Deleting an invoice that is already gone returns 404.

Requires one ofinvoices:write write:draft write:ledger

Path parameters

idstring (uuid)Required
Invoice ID

Errors

401Invalid or missing authentication
403Missing scope, or the company is archived
404The resource does not exist in this company
409The invoice is not a draft, or it is being booked right now
429Rate limit exceeded
500Internal Server Error

Every error has the same shape. See Errors.

cURL

curl -X DELETE https://api.numina.app/v1/invoices/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer numi_YOUR_API_KEY"

JavaScript

const response = await fetch("https://api.numina.app/v1/invoices/550e8400-e29b-41d4-a716-446655440000", {
  method: "DELETE",
  headers: {
    Authorization: `Bearer ${process.env.NUMINA_API_KEY}`,
  },
});

const data = await response.json();

Python

import os

import requests

response = requests.delete(
    "https://api.numina.app/v1/invoices/550e8400-e29b-41d4-a716-446655440000",
    headers={
        "Authorization": f"Bearer {os.environ['NUMINA_API_KEY']}",
    },
)
data = response.json()