Quick Start

Send a JSON request and get an EU-VAT-correct invoice PDF back in under a minute.

InvoicePDF is a paid API. It turns one JSON request into a finished, legally correct invoice or receipt PDF: header with logo and invoice metadata, seller/buyer blocks, a line-items table with right-aligned amounts, a VAT breakdown, and a totals box.

InvoicePDF is a commercial product, not open source. Access is sold through API marketplaces — see Authentication.

What it does

Send seller, buyer, lineItems, currency, and locale to POST /v1/invoice. The response body is a finished PDF. No template to design, no VAT math to write, no locale formatting to handle.

  • Per-line and summary VAT calculation, with exact integer arithmetic
  • Per-rate and per-line rounding modes
  • Reverse-charge handling with the mandatory legal note
  • 20 ISO 4217 currencies, including zero-decimal currencies like JPY
  • Locale-aware number and date formatting

A minimal request

The smallest valid request needs a seller, a buyer, one line item, and a currency. Everything else defaults sensibly (locale → en-IE, taxMode → summary, rounding → per_rate).

bash
curl -X POST https://<marketplace-base-url>/v1/invoice \
  -H "Content-Type: application/json" \
  -d '{
    "invoiceNumber": "2026-0042",
    "issueDate": "2026-07-08",
    "currency": "EUR",
    "seller": {
      "name": "Nordvik Consulting OÜ",
      "address": ["Tallinn, Estonia"],
      "vatId": "EE102938475"
    },
    "buyer": {
      "name": "Acme GmbH",
      "address": ["Str. 1", "10115 Berlin", "Germany"]
    },
    "lineItems": [
      {
        "description": "Consulting, July",
        "quantity": "10",
        "unitPrice": "100.00",
        "taxCategory": "standard",
        "taxRate": "19"
      }
    ]
  }' \
  -o invoice.pdf

This is a request against the live production API — no sandbox mode. It returns a PDF binary. Save it with -o or read Content-Type: application/pdf in the response headers.

Requests are made through the marketplace, not directly to this origin — the real base URL and authentication header name come from the marketplace listing. See Authentication.

Verify the service is up

bash
curl https://invoicepdf.annave.tech/v1/health
# {"status":"ok","version":"1.0.0"}

Next steps