Vehicle Catalog

Vehicle catalog

The vehicle form can fill in make, model, generation and technical data from a catalog that ships with torq. Lookups never leave your server and need no API key. Every field also accepts your own text, so unlisted vehicles, imports and engine swaps can always be saved.

HSN/TSN quick-fill

Type the manufacturer and type key from the German registration certificate (Zulassungsbescheinigung Teil I, fields 2.1 and 2.2) to fill make and model. If several variants share a key, torq offers them to pick from. Undo reverts the fill.

Make → model → chassis code → engine

The searchable lists cascade: picking an engine fills engine code, power, displacement and fuel type.

• Model names follow your language, e.g. "C-Class" in English and "C-Klasse" in German.
• Generations are chassis codes where known (W203, S203, E46, Golf IV (1J), Astra H), with body style and production years as extra detail. Covered: Mercedes-Benz, BMW, Volkswagen, Audi, Porsche and Opel. Other makes show the production years.

Tip

The chassis codes come from a hand-maintained table, chassis.txt, because the data sources only carry production years. Corrections and additions are welcome as pull requests.

Updating the catalog

The catalog is imported into the database on first start and after an upgrade that bundles newer data. Administrators can also refresh it online under Settings → About & data sources → Update now: torq downloads the current KBA FZ 6 list and the latest vehicle-makes-models data, rebuilds the catalog and swaps it in one transaction. Lookups keep working meanwhile; a failed update leaves the previous catalog in place.

An online catalog is kept across restarts until a torq release bundles newer data. Set TORQ_CATALOG_ONLINE_UPDATES=false to remove the button and keep torq fully offline.

Data sources and licenses

• KBA FZ 6 (Kraftfahrt-Bundesamt), under Datenlizenz Deutschland – Namensnennung – Version 2.0.
• vehicle-makes-models (gor3a, compiled from autoevolution.com), under the Open Database License 1.0.

The combined catalog is distributed under the ODbL 1.0. The exact attributions, retrieval dates and all transformations are in NOTICE.md and in the app under Settings → About & data sources.

Note

The KBA's SV 4.2 directory, which has kW, cm³ and fuel per HSN/TSN, is published as "all rights reserved" and is therefore not bundled. That is why an HSN/TSN lookup fills make and model only; the technical data comes from the engine list or your own entry.