v1

latestOpenAPI 3.1.0Free tier — see pricing2026-07-1371721.2 KB

Invoices

Generate an invoice

Compute totals and return JSON (default), a PDF, or UBL 2.1 XML. Anonymous calls (no auth) are allowed for JSON output and are IP-rate-limited; PDF/UBL output requires a free API key. Send an Idempotency-Key header to make retries safe.

post/api/generate-invoice

Headers

Idempotency-Keystring

Opaque key; a repeat with the same key replays the first response (24h).

Request body

global_taxnumber

Single % applied when no per-item tax is set.

global_discountnumber

global_discount_type'percent' | 'amount'

shippingnumber

shipping_labelstring

depositnumber

rounding'none' | 'nearest' | 'up' | 'down'

amount_paidnumber

template'classic' | 'modern' | 'bold' | 'minimal' | 'navy'

accent_colorstring

signaturestring

Image URL (https) or data: URI (png/jpeg).

output'json' | 'pdf' | 'ubl'

notesstring

refund_policystring

footerstring

Example request

{
  "invoice": {
    "currency": "USD"
  },
  "items": [
    {
      "taxes": [
        {
          "name": "VAT"
        }
      ]
    }
  ],
  "global_taxes": [
    {
      "name": "VAT"
    }
  ]
}

Response

Invoice generated.

{"stackTrail":"components:schemas:InvoiceJsonResponse:properties:success","oasType":"schema","type":"unknown"}

anonymousboolean

All 7 operations