XRechnung to PDF API
Upload an XRechnung XML file and receive a human-readable PDF preview.
https://api.invoicexml.com/v1/render/xrechnung/to/pdf
- UBL or CII syntax detected for you
- Older and current XRechnung files
- Labels in English, German or French
- Optional logo and payment QR code
Technical reference
Upload an XRechnung XML file (CII or UBL syntax) and receive a clean, professionally formatted PDF preview. The API parses the XML, maps every EN 16931 Business Term to a readable layout, and returns a downloadable PDF. The rendered PDF is for human readability only, it carries no legal standing.
POST /v1/render/xml/to/pdf,
which accepts any supported invoice XML and detects the syntax itself. Both routes behave identically, so keep this one if the explicit format documents intent, or switch to the generic one to drop the format check from your code.
Code Example
curl -X POST https://api.invoicexml.com/v1/render/xrechnung/to/pdf \ -H "Authorization: Bearer YOUR_API_KEY" \ -F "[email protected]" \ -F "language=en"
Request
| Parameter | Type | Description |
|---|---|---|
| file * | binary | The XML invoice file to render as PDF. |
| language | string | Language for PDF labels and date formatting. Values: en, de, fr. Defaults to en. |
| logo | binary | Your logo, printed top-left as the create endpoints print it: a PNG or JPEG file part of at most 2 MB and 4 megapixels, re-encoded before embedding. Send either this or logoUrl, not both. |
| logoUrl | string | Public URL of your logo instead of the file itself, with the same limits. The API fetches it with the same protections as the create endpoints' pdfUrl. |
| includeQrCode | boolean | Prints an EPC QR code (GiroCode) in the payment section, exactly as the create endpoints' options.includeQrCode does: a banking app turns it into a pre-filled SEPA credit transfer. Printed when the invoice is in EUR, carries a valid IBAN, is paid by credit transfer and has an amount due. Defaults to false. |
Content-Type: multipart/form-data
Headers
| Header | Value |
|---|---|
| Authorization * | Bearer YOUR_API_KEY |
| Content-Type | multipart/form-data |
Response
200 Rendered PDF
Returns the rendered PDF as a binary file.
Useful resources
Companion material for integrating against the API.
Runnable XRechnung integration samples in C#, Java, PHP, Python, Node.js, and browser JavaScript, ready to clone and adapt.
InvoiceXML/xrechnung-api-examples
Run this endpoint on your own file or data straight from your browser, no code and no sign-up required.
www.invoicexml.com/api/render/xrechnung
The full OpenAPI 3.1 document. Drop it into Postman, Insomnia, or any code generator to scaffold a client.
api.invoicexml.com/v1/openapi
Browse and call every endpoint directly from the browser, powered by Scalar.
api.invoicexml.com/v1/scalar
Frequently Asked Questions
Ready to automate your invoices?
Validate, convert and embed compliant e-invoices through one API. Start your 30-day free trial. No credit card required.