Invoices

Delete Draft Invoice

Permanently removes a draft invoice. Only legal while in draft (no number issued); finalized invoices must be voided instead so the audit trail stays intact.

Authorization

AuthorizationRequiredBearer <token>

API key as Bearer token

In: header

Path Parameters

idRequiredstring

Invoice id, discoverable via list_invoices

DELETE/v1/invoices/{id}

curl -X DELETE "https://api.3common.com/v1/invoices/string" \
  -H "Authorization: Bearer <token>"

Default Response

Response

{
  "data": {
    "id": "string"
  }
}

TypeScript

export interface Response {
  data: {
    /**
     * Id of the deleted invoice
     */
    id: string;
  };
}

Revise Invoice

Edits a draft invoice. Only legal while in draft — use void plus create-new for finalized invoices. Totals recompute when line items change.

Finalize Invoice

Transitions a draft invoice to open, assigns a sequential number, and stamps issuedAt. Pass sendEmail=true to also email the customer their invoice (payment-link, or receipt for a zero-dollar auto-pay) as part of finalizing.