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.
- No SDK needed: send XML, PDF or JSON, get JSON, XML or PDF back
- Invoices are processed in memory and never stored
- Error messages in English, German and French, with the EN 16931 rule ID
- Runs on Cloudflare's network, close to your servers
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.
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.
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.
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.
IBAN check: country length, check digits, SEPA membership, bank code.
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.
Up to 100 VAT IDs per call: {"vat_ids": ["DE…", "FR…"]}. Counts one call per number.
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.
Business
199 € / month
100,000 calls / month
- All endpoints
- No branding
- DPA on request
- Priority support
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.