API quick start

The API for XRechnung and ZUGFeRD in accounting, ERP, and finance software.

XInvoice is built for developers and product teams that want to integrate German e-invoicing quickly, validate documents reliably, and deliver results safely in production.

100 free API calls in the first 30 days Use it synchronously or asynchronously JSON input instead of low-level XML plumbing

How to get to the first invoice quickly

The technical entry path is meant to stay friction-light: validate first, then generate, then retrieve status or artifacts.

  1. 1 Register an account and create an API key in the dashboard.
  2. 2 Use validate to check sample data or existing invoice documents.
  3. 3 Use generate to create XML or PDF and retrieve the result by invoice ID.

Fast time to first result

One API key, one JSON request, and immediately usable responses for validate, generate, and status lookups.

Compliance without guesswork

Official validation artifacts, structured findings, and reproducible response schemas for integrations.

Self-service for product teams

Registration, plan selection, API key rotation, invoice downloads, and security features in the customer portal.

How to get to the first invoice quickly

The technical entry path is meant to stay friction-light: validate first, then generate, then retrieve status or artifacts.

curl -X POST https://api.xinvoice.net/v1/invoices/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Prefer: respond-sync" \
  -d @payload.json
Generate call with JSON payload and synchronous response for a quick proof of concept.

Typical integration flow

  1. 1 Choose an API plan, register an account, and create an API key.
  2. 2 Run the documented sample requests with your first invoice data.
  3. 3 Use validate for pre-checks and generate for production paths.
  4. 4 Track status via GET /v1/invoices/{id} and retrieve XML or PDF through the API or portal.
Infographic: Creating an E-Invoice (XRechnung / ZUGFeRD) via an API – flow showing client, API confirmation, generation, validation, and polling

What you get technically right away

Formats

XRechnung as UBL or CII plus ZUGFeRD as CII and hybrid PDF for different integration paths.

Response model

Clear status values, structured validation findings, XML output, and PDF downloads per invoice.

Operations

Suitable for sample data, recurring jobs, and asynchronous processing in existing product workflows.

Test the API instead of building more XML edge cases

If you need to generate invoices automatically or validate them safely before delivery, this is the fastest path forward.