E-invoicing API for developers

Validate, convert and create XRechnung, ZUGFeRD / Factur-X and Peppol BIS invoices with one HTTP call. Check IBANs and EU VAT IDs (VIES) on the side. Built for ERP, shop and accounting software that must handle the e-invoicing mandates in Germany (2025–2028), France (2026–2027), Belgium and Poland.

Quickstart

1. Get a key (free plan: 100 calls per month). The key arrives by e-mail.

2. Send an invoice:

curl -X POST "https://rechnix-api.mbanzagroup.workers.dev/v1/validate?lang=en" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/xml" \
  --data-binary @invoice.xml

3. Read the result:

{
  "valid": false,
  "syntax": "CII",
  "profile": "xrechnung",
  "errors": [
    { "rule": "BR-DE-15", "field": "buyerReference",
      "message": "XRechnung: buyer reference / Leitweg-ID (BT-10) is missing." }
  ],
  "warnings": [],
  "summary": { "number": "RE-2027-0042", "total_with_vat": 1339.07, ... }
}

Endpoints

Authentication: header X-API-Key: YOUR_KEY (or Authorization: Bearer YOUR_KEY). Every response carries X-RateLimit-Limit and X-RateLimit-Remaining. Full spec: openapi.json.

POST/v1/validate

Validate an XRechnung (CII or UBL), ZUGFeRD / Factur-X (PDF or XML) or Peppol BIS invoice. Body: the XML file, the PDF file, or JSON {"xml": "..."}. Optional: profile=auto|xrechnung|en16931|peppol, lang=en|de|fr.

POST/v1/convert

Convert between formats. to=xrechnung-cii|xrechnung-ubl|peppol-ubl|en16931-cii|zugferd-xml|zugferd-pdf|json. A ZUGFeRD PDF in, an XRechnung out (or the other way round). Refuses to convert if the source totals do not add up, so amounts never change.

POST/v1/invoices

Create an invoice from JSON. format= same values as above. Checks the rules of the target format first and returns 422 with the list of problems.

GET/v1/iban/{iban}

IBAN check: country length, check digits, SEPA membership, bank code.

GET/v1/vat/{vat_id}

EU VAT ID check: format and check digit offline, then live VIES lookup (name and address when the country shares them). vies=false for offline only.

POST/v1/vat/batch

Up to 100 VAT IDs per call: {"vat_ids": ["DE…", "FR…"]}. Counts one call per number.

GET/v1/usage

Calls used this month and calls left. Free of charge.

Invoice JSON (for /v1/invoices)

Field names follow EN 16931. VAT categories: S (standard), Z, E (exempt), AE (reverse charge), K (intra-EU), G (export), O. Electronic address: endpoint_id + endpoint_scheme (e.g. 0204 Leitweg-ID, 9930 German VAT, 0009 SIRET, 0208 Belgian company number); without them the e-mail is used.

{
  "number": "RE-2027-0042",
  "issue_date": "2027-01-15",
  "due_date": "2027-01-29",
  "currency": "EUR",
  "buyer_reference": "04011000-12345-34",
  "seller": {
    "name": "Muster Design Studio",
    "street": "Lindenstraße 12",
    "postcode": "10115",
    "city": "Berlin",
    "country": "DE",
    "vat_id": "DE123456788",
    "email": "rechnung@muster-design.example",
    "contact_name": "Mia Muster",
    "phone": "+49 30 1234567"
  },
  "buyer": {
    "name": "Stadtverwaltung Musterstadt",
    "street": "Rathausplatz 1",
    "postcode": "12345",
    "city": "Musterstadt",
    "country": "DE",
    "email": "eingang@musterstadt.example",
    "endpoint_id": "04011000-12345-34",
    "endpoint_scheme": "0204"
  },
  "payment": {
    "means_code": "58",
    "iban": "DE02120300000000202051"
  },
  "lines": [
    {
      "name": "Webdesign",
      "quantity": 12.5,
      "unit_code": "HUR",
      "price": 85,
      "vat_category": "S",
      "vat_rate": 19
    }
  ]
}
# ZUGFeRD / Factur-X PDF -> XRechnung UBL
curl -X POST "https://rechnix-api.mbanzagroup.workers.dev/v1/convert?to=xrechnung-ubl" \
  -H "X-API-Key: YOUR_KEY" --data-binary @invoice.pdf -o xrechnung.xml

# JSON -> ZUGFeRD PDF
curl -X POST "https://rechnix-api.mbanzagroup.workers.dev/v1/invoices?format=zugferd-pdf" \
  -H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
  --data @invoice.json -o invoice.pdf

# IBAN and VAT ID
curl -H "X-API-Key: YOUR_KEY" https://rechnix-api.mbanzagroup.workers.dev/v1/iban/DE02120300000000202051
curl -H "X-API-Key: YOUR_KEY" https://rechnix-api.mbanzagroup.workers.dev/v1/vat/FR32123456789

Try it

Uses the public demo key (30 calls per day). The sample is a valid XRechnung; break it and see what the API says.

Pricing

Monthly plans, cancel any time. Payment, VAT and invoices are handled by Polar (merchant of record). A call is one request; a VAT batch counts one call per number.

Free

0 € / month

100 calls / month

  • All endpoints
  • PDF marked "created with"
  • Community support
Get free key

Starter

19 € / month

2,000 calls / month

  • All endpoints
  • No branding on PDFs
  • E-mail support
Choose

Pro

59 € / month

15,000 calls / month

  • All endpoints
  • No branding
  • Priority e-mail support
Choose

Business

199 € / month

100,000 calls / month

  • All endpoints
  • No branding
  • DPA on request
  • Priority support
Choose

Need more than 100,000 calls? Write to us. mbanzagroup@proton.me · Manage your subscription and keys

FAQ

Is this the official validator?

It uses the same rules. Every request is checked against the complete official Schematron rule sets that the KoSIT validator uses: EN 16931 (CEN 1.3.16), XRechnung 3.0.2 (KoSIT) and, for Peppol, Peppol BIS Billing 3.0.21. Each error carries the official rule ID and its location in the XML. XML schema (XSD) validation is not included.

Do you store my invoices?

No. Invoices are read in memory and discarded when the response is sent. We store only a call counter per key and a hash of the key. No invoice content in logs.

Which formats are supported?

XRechnung 3.0 (CII and UBL), ZUGFeRD 2.x / Factur-X 1.0 profile EN 16931 (PDF/A-3 or XML), Peppol BIS Billing 3.0 (UBL), plain EN 16931 CII. Reading: also other ZUGFeRD profiles (basic rules only).

What is not supported yet?

Document-level allowances and charges in conversions (the API refuses instead of dropping them), UBL credit note documents as output, and the Peppol network itself (sending). We publish changes in the changelog of this page.

What happens when my quota is used up?

Calls return HTTP 429 until the next month or until you upgrade. No surprise bills.