Resources / Guides

Is there a LUCID API? German authorised representative workflows for software

We haven't found a public LUCID API for registering or appointing a representative. LUCID's documented interface is an XML file upload for registered companies, so the appointment has to be designed as human steps.

By Razvan Toma · Founder · Last checked 1 November 2026 · Sources below

Know what the XML interface does

ZSVR, which runs LUCID, describes an XML upload for two tasks: quantity reports and brand names. A company logs in and uploads the file in LUCID, so it's a file upload after login, not a web API. Its page describes uploads to an existing registration, and doesn't say an XML file can register a company.

Treat registration as personal

Registering in LUCID stays the producer's own duty. Section 5(2) of the VerpackDG excludes it from what a representative takes over, and ZSVR calls it strictly personal. Your product can guide the client, but it shouldn't log in or register for them.

Related: LUCID registration vs representative ↗

Follow the right order

The mandate comes first, in German, signed by hand or with a qualified electronic signature. The client names the representative in LUCID, and the representative confirms it there. Our sandbox shows the order we run: order_paid, mandate_signed, dual_system_paid, appointed_in_lucid, registered.

We put the dual-system licence before LUCID, and we don't accept the appointment until it's paid.

Related: Try the sandbox

Collect the kilos early

The licence is priced on kilos per material, and the client can enter them in our portal. If you already hold them, send them in germany.packaging_kg and they prefill it, using paper, plastic, glass, ferrous, alu, bevcarton, composite and other. POST /quote returns an estimate from the live Noventiz price. A client whose dual system is already in place sends already_licensed instead.

Related: API documentation

Keep reports matched

ZSVR's help pages say each quantity report made to a dual system must also be made in LUCID, one to one. If your software holds the figures, keep one source for both reports, so that the two can't drift apart.

Sources

Try the API

Check, quote and a simulated run of each country's steps, free and without a key.

Developers