{"openapi":"3.1.0","info":{"title":"api4cars API","version":"2.0.0","description":"Vehicle data and wheel fitment for the German market. Vehicle and display data are German; machine-readable fields carry stable codes. Every response names the active data release in meta.data_version."},"servers":[{"url":"https://api.api4cars.com"}],"x-code-lists":{"body_type":["sedan","hatchback","fastback","estate","coupe","convertible","suv","van","pickup","panel_van"],"fuel":["petrol","diesel","electric","hybrid","mild_hybrid","plugin_hybrid","lpg","cng","hydrogen","other"],"transmission":["manual","automatic","dual_clutch","automated_manual","cvt","single_speed"],"drivetrain":["front","rear","all"]},"security":[{"ApiKey":[],"ApiSecret":[]},{"Bearer":[]}],"tags":[{"name":"Navigation"},{"name":"Vehicles"},{"name":"Vehicle search"},{"name":"Wheels on vehicle"},{"name":"Wheel catalog"},{"name":"Documents"},{"name":"Insurance"},{"name":"Configurator images"},{"name":"Service"}],"paths":{"/v2/status":{"get":{"tags":["Service"],"summary":"Service status and active data release","security":[],"responses":{"200":{"description":"Service is up.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Status"},"meta":{"$ref":"#/components/schemas/Meta"},"attribution":{"$ref":"#/components/schemas/Attribution"}}},"example":{"data":{"status":"ok","data_version":"2026-11-20.ea6570d403d7","checks":{"worker":"ok","accounts_db":"ok","data_db":"ok"}},"meta":{"api_version":2,"data_version":"2026-11-20.ea6570d403d7"}}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"}}},"304":{"description":"Unchanged response; use the previously cached body. No response body. Authenticated requests still count towards usage.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"}}},"400":{"$ref":"#/components/responses/E400"},"405":{"$ref":"#/components/responses/E405"},"503":{"$ref":"#/components/responses/E503"}},"x-example-request":"/v2/status","parameters":[{"name":"If-None-Match","in":"header","required":false,"schema":{"type":"string"},"description":"ETag for the same request; unchanged: 304 without a body."}]}},"/v2/me":{"get":{"tags":["Service"],"summary":"Own API key: monthly quota and usage","responses":{"200":{"description":"Key usage.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Me"},"meta":{"$ref":"#/components/schemas/Meta"},"attribution":{"$ref":"#/components/schemas/Attribution"}}},"example":{"data":{"api_key":"ck_v2_example","label":"Website","month":"2026-11","quota_scope":"account","monthly_limit":10000,"remaining":9988,"reset_at":"2026-12-01T00:00:00Z","overage_allowed":false,"requests_this_month":5,"quota_reported_at":"2026-11-18T08:00:00Z","quota_warning":null},"meta":{"api_version":2,"data_version":"2026-11-20.ea6570d403d7"}}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"X-RateLimit-Limit":{"$ref":"#/components/headers/MonthlyLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/MonthlyRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/MonthlyReset"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"}}},"304":{"description":"Usage may have changed despite 304. Do not send If-None-Match or reuse a cached body on /v2/me or /v2/me/usage; always request fresh usage data. If received, repeat the request without If-None-Match.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"X-RateLimit-Limit":{"$ref":"#/components/headers/MonthlyLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/MonthlyRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/MonthlyReset"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"403":{"$ref":"#/components/responses/E403"},"405":{"$ref":"#/components/responses/E405"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"503":{"$ref":"#/components/responses/E503"}},"x-example-request":"/v2/me","parameters":[{"name":"If-None-Match","in":"header","required":false,"schema":{"type":"string"},"description":"Do not send If-None-Match or reuse a cached body on /v2/me or /v2/me/usage; always request fresh usage data."}]}},"/v2/me/usage":{"get":{"tags":["Service"],"summary":"Own API key: requests per day and endpoint","description":"Request counts of the calling key per UTC day and endpoint (path template, no vehicle ids or parameters). Defaults to the last 30 days; at most 92 days per request. Days without requests are omitted. Counts match the monthly quota counter: every authenticated request that was not stopped by the short-term brake, including this one.","parameters":[{"name":"from","in":"query","required":false,"schema":{"type":"string","format":"date"},"description":"First day (UTC), YYYY-MM-DD. Default: 29 days before to."},{"name":"to","in":"query","required":false,"schema":{"type":"string","format":"date"},"description":"Last day (UTC), YYYY-MM-DD. Default: today."},{"name":"If-None-Match","in":"header","required":false,"schema":{"type":"string"},"description":"Do not send If-None-Match or reuse a cached body on /v2/me or /v2/me/usage; always request fresh usage data."}],"responses":{"200":{"description":"Usage log.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Usage"},"meta":{"$ref":"#/components/schemas/Meta"},"attribution":{"$ref":"#/components/schemas/Attribution"}}},"example":{"data":{"api_key":"ck_v2_example","label":"Website","month":"2026-11","quota_scope":"key","monthly_limit":10000,"remaining":9995,"reset_at":"2026-12-01T00:00:00Z","overage_allowed":false,"requests_this_month":5,"quota_reported_at":null,"quota_warning":null,"from":"2026-11-17","to":"2026-11-18","requests":5,"endpoints":[{"endpoint":"/v2/vehicles/{vehicle_id}","requests":2},{"endpoint":"/v2/vehicles/{vehicle_id}/wheels","requests":3}],"days":[{"day":"2026-11-17","requests":2,"endpoints":[{"endpoint":"/v2/vehicles/{vehicle_id}","requests":2}]},{"day":"2026-11-18","requests":3,"endpoints":[{"endpoint":"/v2/vehicles/{vehicle_id}/wheels","requests":3}]}]},"meta":{"api_version":2,"data_version":"2026-11-20.ea6570d403d7"}}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"X-RateLimit-Limit":{"$ref":"#/components/headers/MonthlyLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/MonthlyRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/MonthlyReset"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"}}},"304":{"description":"Usage may have changed despite 304. Do not send If-None-Match or reuse a cached body on /v2/me or /v2/me/usage; always request fresh usage data. If received, repeat the request without If-None-Match.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"X-RateLimit-Limit":{"$ref":"#/components/headers/MonthlyLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/MonthlyRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/MonthlyReset"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"403":{"$ref":"#/components/responses/E403"},"405":{"$ref":"#/components/responses/E405"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"503":{"$ref":"#/components/responses/E503"}},"x-example-request":"/v2/me/usage?from=2026-11-17&to=2026-11-18"}},"/v2/openapi.json":{"get":{"tags":["Service"],"summary":"This description","security":[],"responses":{"200":{"description":"OpenAPI document."}}}},"/v2/brands":{"get":{"tags":["Navigation"],"summary":"Brands","parameters":[{"name":"with_fitments","in":"query","required":false,"schema":{"type":"string","enum":["0","1"]},"description":"Only brands with wheel assignments."},{"name":"with_logo","in":"query","required":false,"schema":{"type":"string","enum":["0","1"]},"description":"Only brands with a logo."},{"name":"If-None-Match","in":"header","required":false,"schema":{"type":"string"},"description":"ETag for the same request; unchanged: 304 without a body."}],"responses":{"200":{"description":"List of brands.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Brand"}},"meta":{"$ref":"#/components/schemas/Meta"}}},"example":{"data":[{"id":"bmw","name":"BMW","vehicle_count":2303,"with_fitments_count":2187,"logo_url":"https://cdn.api4cars.com/brand-logos/bmw.jpeg"},{"id":"aiways","name":"Aiways","vehicle_count":4,"with_fitments_count":1,"logo_url":"https://cdn.api4cars.com/brand-logos/aiways.jpeg"}],"meta":{"api_version":2,"data_version":"2026-11-20.ea6570d403d7"}}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"X-RateLimit-Limit":{"$ref":"#/components/headers/MonthlyLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/MonthlyRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/MonthlyReset"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"}}},"304":{"description":"Unchanged response; use the previously cached body. No response body. Authenticated requests still count towards usage.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"X-RateLimit-Limit":{"$ref":"#/components/headers/MonthlyLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/MonthlyRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/MonthlyReset"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"403":{"$ref":"#/components/responses/E403"},"405":{"$ref":"#/components/responses/E405"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"503":{"$ref":"#/components/responses/E503"}},"x-example-request":"/v2/brands?with_logo=1"}},"/v2/brands/{brand_id}/models":{"get":{"tags":["Navigation"],"summary":"Models of a brand","parameters":[{"name":"brand_id","in":"path","required":true,"schema":{"type":"string"},"description":"Brand id from /v2/brands."},{"name":"with_fitments","in":"query","required":false,"schema":{"type":"string","enum":["0","1"]},"description":"Only models with wheel assignments."},{"name":"If-None-Match","in":"header","required":false,"schema":{"type":"string"},"description":"ETag for the same request; unchanged: 304 without a body."}],"responses":{"200":{"description":"Models.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Model"}},"meta":{"$ref":"#/components/schemas/Meta"}}},"example":{"data":[{"id":"3er-reihe","name":"3er-Reihe","with_fitments_count":413},{"id":"1er-reihe","name":"1er-Reihe","with_fitments_count":161}],"meta":{"api_version":2,"data_version":"2026-11-20.ea6570d403d7"}}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"X-RateLimit-Limit":{"$ref":"#/components/headers/MonthlyLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/MonthlyRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/MonthlyReset"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"}}},"304":{"description":"Unchanged response; use the previously cached body. No response body. Authenticated requests still count towards usage.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"X-RateLimit-Limit":{"$ref":"#/components/headers/MonthlyLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/MonthlyRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/MonthlyReset"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"405":{"$ref":"#/components/responses/E405"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"503":{"$ref":"#/components/responses/E503"}},"x-example-request":"/v2/brands/bmw/models"}},"/v2/brands/{brand_id}/models/{model_id}/generations":{"get":{"tags":["Navigation"],"summary":"Generations of a model, with executions","parameters":[{"name":"brand_id","in":"path","required":true,"schema":{"type":"string"},"description":"Brand id."},{"name":"model_id","in":"path","required":true,"schema":{"type":"string"},"description":"Model id."},{"name":"If-None-Match","in":"header","required":false,"schema":{"type":"string"},"description":"ETag for the same request; unchanged: 304 without a body."}],"responses":{"200":{"description":"Generations.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Generation"}},"meta":{"$ref":"#/components/schemas/Meta"}}},"example":{"data":[{"id":"gen_bc474a916036aba5","name":"3er-Reihe E36","year_from":"1990-09","year_to":"2000-08","years_label":"09/1990 – 08/2000","brand_id":"bmw","model_id":"3er-reihe","executions":[{"id":"execution-21f77b04bf12c110","label":"Coupé","body_type_code":"coupe","body_type_label":"Coupé","engine_count":9},{"id":"execution-5b418b9b915aef9b","label":"Kombi","body_type_code":"estate","body_type_label":"Kombi","engine_count":7}]}],"meta":{"api_version":2,"data_version":"2026-11-20.ea6570d403d7"}}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"X-RateLimit-Limit":{"$ref":"#/components/headers/MonthlyLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/MonthlyRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/MonthlyReset"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"}}},"304":{"description":"Unchanged response; use the previously cached body. No response body. Authenticated requests still count towards usage.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"X-RateLimit-Limit":{"$ref":"#/components/headers/MonthlyLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/MonthlyRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/MonthlyReset"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"405":{"$ref":"#/components/responses/E405"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"503":{"$ref":"#/components/responses/E503"}},"x-example-request":"/v2/brands/bmw/models/3er-reihe/generations"}},"/v2/generations/{generation_id}/engines":{"get":{"tags":["Navigation"],"summary":"Engines of a generation with their vehicles and selections","parameters":[{"name":"generation_id","in":"path","required":true,"schema":{"type":"string","pattern":"^gen_[a-f0-9]{16}$"},"description":"Generation id."},{"name":"execution","in":"query","required":false,"schema":{"type":"string"},"description":"Execution id from the generation."},{"name":"If-None-Match","in":"header","required":false,"schema":{"type":"string"},"description":"ETag for the same request; unchanged: 304 without a body."}],"responses":{"200":{"description":"Engines.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Engine"}},"meta":{"$ref":"#/components/schemas/Meta"}}},"example":{"data":[{"name":"318d","label":"318d · Hinterrad · Automatikgetriebe (150 PS / 110 kW)","engine_names":["318d"],"power_kw":110,"power_ps":150,"fuel_code":"diesel","fuel_label":"Diesel","drivetrain_code":"rear","drivetrain_label":"Heckantrieb","transmission_codes":["automatic"],"transmission_labels":["Automatikgetriebe"],"year_from":"2022-07","year_to":"2024-05","years_label":"07/2022 – 05/2024","execution":{"id":"execution-8b34ee96f6a35820","label":"Limousine","body_type_code":"sedan","body_type_label":"Limousine"},"vehicles":[{"id":"0005-DDL","selections":["var_g20-2022-110kw-diesel-identity-27e4b4ff520ba819"]}]},{"name":"318i","label":"318i · Hinterrad · Automatikgetriebe (156 PS / 115 kW)","engine_names":["318i"],"power_kw":115,"power_ps":156,"fuel_code":"petrol","fuel_label":"Benzin","drivetrain_code":"rear","drivetrain_label":"Heckantrieb","transmission_codes":["automatic"],"transmission_labels":["Automatikgetriebe"],"year_from":"2022-07","year_to":"2024-05","years_label":"07/2022 – 05/2024","execution":{"id":"execution-8b34ee96f6a35820","label":"Limousine","body_type_code":"sedan","body_type_label":"Limousine"},"vehicles":[{"id":"0005-CYI","selections":["var_g20-2022-115kw-benzin"]}]}],"meta":{"api_version":2,"data_version":"2026-11-20.ea6570d403d7"}}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"X-RateLimit-Limit":{"$ref":"#/components/headers/MonthlyLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/MonthlyRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/MonthlyReset"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"}}},"304":{"description":"Unchanged response; use the previously cached body. No response body. Authenticated requests still count towards usage.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"X-RateLimit-Limit":{"$ref":"#/components/headers/MonthlyLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/MonthlyRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/MonthlyReset"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"405":{"$ref":"#/components/responses/E405"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"503":{"$ref":"#/components/responses/E503"}},"x-example-request":"/v2/generations/gen_55652f125d2a029c/engines?execution=execution-8b34ee96f6a35820"}},"/v2/vehicles":{"get":{"tags":["Vehicle search"],"summary":"Search vehicle variants by name, body, powertrain, dimensions, production year and towing capacity","description":"One result per vehicle variant. Text filters ignore case and accents. With min_braked_kg this is the towing search. Trailer limits are variant-specific; confirm the registration certificate before use.","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","minLength":2,"maxLength":100},"description":"Brand, model, label or engine code contains this text (2–100 characters)."},{"name":"brand","in":"query","required":false,"schema":{"type":"string","maxLength":100},"description":"Brand contains this text."},{"name":"model","in":"query","required":false,"schema":{"type":"string","maxLength":100},"description":"Model or label contains this text."},{"name":"body_type","in":"query","required":false,"schema":{"type":"string"},"description":"Comma-separated codes of the code list body_type (as body_type_code)."},{"name":"fuel","in":"query","required":false,"schema":{"type":"string"},"description":"Comma-separated codes of the code list fuel (as fuel_code)."},{"name":"transmission","in":"query","required":false,"schema":{"type":"string"},"description":"Comma-separated codes of the code list transmission (as transmission_code)."},{"name":"drive_type","in":"query","required":false,"schema":{"type":"string"},"description":"Comma-separated codes of the code list drivetrain (as drivetrain_code)."},{"name":"doors","in":"query","required":false,"schema":{"type":"integer","minimum":0},"description":"Exact doors."},{"name":"seats","in":"query","required":false,"schema":{"type":"integer","minimum":0},"description":"Exact seats."},{"name":"production_start","in":"query","required":false,"schema":{"type":"integer","minimum":0},"description":"Exact production start."},{"name":"production_end","in":"query","required":false,"schema":{"type":"integer","minimum":0},"description":"Exact production end."},{"name":"min_length_mm","in":"query","required":false,"schema":{"type":"integer","minimum":0},"description":"Minimum length mm."},{"name":"max_length_mm","in":"query","required":false,"schema":{"type":"integer","minimum":0},"description":"Maximum length mm."},{"name":"min_width_mm","in":"query","required":false,"schema":{"type":"integer","minimum":0},"description":"Minimum width mm."},{"name":"max_width_mm","in":"query","required":false,"schema":{"type":"integer","minimum":0},"description":"Maximum width mm."},{"name":"min_height_mm","in":"query","required":false,"schema":{"type":"integer","minimum":0},"description":"Minimum height mm."},{"name":"max_height_mm","in":"query","required":false,"schema":{"type":"integer","minimum":0},"description":"Maximum height mm."},{"name":"min_power_kw","in":"query","required":false,"schema":{"type":"integer","minimum":0},"description":"Minimum power kw."},{"name":"max_power_kw","in":"query","required":false,"schema":{"type":"integer","minimum":0},"description":"Maximum power kw."},{"name":"min_braked_kg","in":"query","required":false,"schema":{"type":"integer","minimum":0},"description":"Minimum braked kg."},{"name":"max_braked_kg","in":"query","required":false,"schema":{"type":"integer","minimum":0},"description":"Maximum braked kg."},{"name":"min_nose_weight_kg","in":"query","required":false,"schema":{"type":"integer","minimum":0},"description":"Minimum nose weight kg."},{"name":"max_nose_weight_kg","in":"query","required":false,"schema":{"type":"integer","minimum":0},"description":"Maximum nose weight kg."},{"name":"production_year","in":"query","required":false,"schema":{"type":"integer","minimum":0},"description":"Built in this year (documented period; ongoing production counts from its start)."},{"name":"include","in":"query","required":false,"schema":{"type":"string","enum":["facets"]},"description":"facets: counts per brand, body type, fuel, transmission and drive type for the whole result."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100},"description":"Page size (default 50)."},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"},"description":"Opaque cursor from meta.next_cursor."},{"name":"data_version","in":"query","required":false,"schema":{"type":"string"},"description":"Optional: fail with 409 if the active data release differs."},{"name":"If-None-Match","in":"header","required":false,"schema":{"type":"string"},"description":"ETag for the same request; unchanged: 304 without a body."}],"responses":{"200":{"description":"Vehicle variants ordered by brand, model and power.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/VehicleVariant"}},"meta":{"$ref":"#/components/schemas/MetaSearch"},"attribution":{"$ref":"#/components/schemas/Attribution"}}},"example":{"data":[{"vehicle_id":"0005-DMY","brand":"BMW","model":"1er Reihe","label":"118d","body_type_code":"hatchback","body_type_label":"Schrägheck","fuel_code":"diesel","fuel_label":"Diesel","drivetrain_code":"front","drivetrain_label":"Frontantrieb","year_from":"2024","years_label":"ab 2024","body":{"doors":5,"seats":5},"dimensions":{"length_mm":4360,"width_mm":1800,"height_mm":1460},"powertrain":{"displacement_ccm":1995},"weights":{"curb_kg":1540,"gross_kg":2050},"towing":{"braked_kg":1300,"unbraked_kg":750,"nose_weight_kg":75},"engine":{"type":"Dieselmotor","codes":["B47C20B"],"codes_normalized":["B47C20B"]},"completeness":23}],"meta":{"api_version":2,"data_version":"2026-11-20.ea6570d403d7","total":420,"next_cursor":"eyJ2IjoiMjAyNi0xMS0yMC5lYTY1NzBkNDAzZDciLCJrIjoidmVoaWNsZV9zZWFyY2giLCJpZCI6InZlaGljbGVfc2VhcmNofC92Mi92ZWhpY2xlc3xicmFuZD1CTVcmcT1CNDciLCJwIjoxfQ"},"attribution":[{"source":"kba","publisher":"Kraftfahrt-Bundesamt (KBA)","license":{"name":"Datenlizenz Deutschland – Namensnennung – Version 2.0","id":"dl-de/by-2-0","url":"https://www.govdata.de/dl-de/by-2-0"},"datasets":[{"name":"FZ 6 – Bestand an Kraftfahrzeugen und Kraftfahrzeuganhängern nach Herstellern und Typen, Stand 01.01.2026","url":"https://data.gov.de/suche/daten/fz-6-2026-bestand-an-kraftfahrzeugen-und-kraftfahrzeuganhangern-nach-hersteller-und-typen-am-1-?ids=6ae58c67-8615-4417-85e3-fd05fbfae605"},{"name":"FZ Hersteller Handelsnamen Pkw","url":"https://data.gov.de/suche/daten/fz-hersteller-handelsnamen-pkw"},{"name":"KBA-Verzeichnis SV 4.2, Stand 15.08.2026","url":"https://www.kba.de/SharedDocs/Downloads/DE/SV/sv42_pdf.pdf"}],"note":"Daten verändert: eigene Berechnungen auf Grundlage von Daten des Kraftfahrt-Bundesamtes"}]}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"X-RateLimit-Limit":{"$ref":"#/components/headers/MonthlyLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/MonthlyRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/MonthlyReset"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"}}},"304":{"description":"Unchanged response; use the previously cached body. No response body. Authenticated requests still count towards usage.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"X-RateLimit-Limit":{"$ref":"#/components/headers/MonthlyLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/MonthlyRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/MonthlyReset"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"403":{"$ref":"#/components/responses/E403"},"405":{"$ref":"#/components/responses/E405"},"409":{"$ref":"#/components/responses/E409"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"503":{"$ref":"#/components/responses/E503"}},"x-example-request":"/v2/vehicles?brand=BMW&q=B47&limit=1"}},"/v2/vehicles/{vehicle_id}":{"get":{"tags":["Vehicles"],"summary":"Vehicle with selections","parameters":[{"name":"vehicle_id","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9]{4}-[A-Z0-9]{3}$"},"description":"HSN-TSN, e.g. 0005-DFY."},{"name":"selection","in":"query","required":false,"schema":{"type":"string"},"description":"Selection id from the vehicle (var_…, als_…, cfg_…). The chosen selection is returned as selected; for a variant the bolt pattern and center bore are those of the variant and include=data_sheet is narrowed to the data sheets of the variant. meta.selection tells what was applied."},{"name":"vsn","in":"query","required":false,"schema":{"type":"string","pattern":"^[A-Za-z0-9]{5}[A-Za-z0-9-]?$"},"description":"VSN from field 2.2 of the registration certificate (positions 4–8, optionally with the check digit). Preselects the variant when exactly one variant of the vehicle carries this VSN (as selection=var_…); otherwise the result is the one without selection and meta.vsn_selection says why. A sent selection takes precedence. 00000 means the version cannot be determined."},{"name":"include","in":"query","required":false,"schema":{"type":"string"},"description":"Comma-separated list of extra blocks, any of: insurance, market, market_history, safety, environment, data_sheet (e.g. include=market,safety). insurance: insurance type classes (liability, partial and full comprehensive) with annual values; insurance_unavailable when none are known. market, safety, environment: official statistics and recalls for this vehicle. market_history: the stock of exactly this HSN/TSN per year (1 January) and its trend. intelligence_unavailable when the data release has none of the requested sections. data_sheet: technical data sheet with numeric values and the unit in the field name; data_sheet_unavailable when none is known. vehicle_image: preview image of the vehicle for configurators (signed link, valid at least one hour; expires_at). sections: which detail sections have content for this vehicle (workshop, market, recalls). An unknown value gives 400 invalid_include."},{"name":"If-None-Match","in":"header","required":false,"schema":{"type":"string"},"description":"ETag for the same request; unchanged: 304 without a body."}],"responses":{"200":{"description":"Vehicle.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Vehicle"},"meta":{"$ref":"#/components/schemas/MetaVehicle"},"attribution":{"$ref":"#/components/schemas/Attribution"}}},"example":{"data":{"vehicle_id":"0005-DDL","hsn":"0005","tsn":"DDL","brand":"BMW","model":"Limousine - G3L (G20)","year_from":"2020","year_to":null,"years_label":"ab 2020","display":{"brand":"BMW","model":"3er-Reihe","trim":"318d","series":"3er-Reihe (G20)","series_code":"G20"},"wheels":{"pcd":"5x112","pcd_status":"verified","center_bore_mm":66.6,"center_bore_status":"verified","thread":"M14X1.25","torque_nm":140,"fastener":"Radschrauben","fastener_code":"bolts"},"tpms":{"type":"active","requires_sensor":true},"oe_tires":[{"front":"225/50R17 98Y","front_wheel":"7.5x17 ET30"},{"front":"225/45R18 95Y","front_wheel":"7.5x18 ET25"}],"factory_wheels":{"references":["7.5x17 ET30","7.5x18 ET25","8.0x19 ET27","8.0x20 ET27","8.5x18 ET40","8.5x19 ET40","8.5x20 ET40"],"options":[{"front":"225/50R17 98Y","front_wheel":"7.5x17 ET30","staggered":false},{"front":"225/40R19 93Y","rear":"255/35R19 96Y","front_wheel":"8.0x19 ET27","rear_wheel":"8.5x19 ET40","staggered":true}]},"brand_id":"bmw","brand_logo_url":"https://cdn.api4cars.com/brand-logos/bmw.jpeg","has_wheels":true,"selections":[{"selection_id":"var_g20-2019-110kw-diesel","kind":"variant","label":"318d Typ G20, 2,0l 318d 110 kW (150 PS)","series_code":"G20","year_from":"2020","year_to":"2022","years_label":"2020 – 2022","power_kw":110,"power_ps":150,"displacement_ccm":1995,"fuel_code":"diesel","fuel_label":"Diesel","drivetrain_code":"rear","drivetrain_label":"Heckantrieb","body_type_code":"sedan","body_type_label":"Limousine","pcd":"5x112","center_bore_mm":66.6,"oe_tires":[{"front":"205/60R16W"},{"front":"225/50R17Y"}],"vsns":["00038"],"wheels_available":true},{"selection_id":"var_g20-2022-110kw-diesel-identity-27e4b4ff520ba819","kind":"variant","label":"318d Typ G20 Facelift 2022, 2,0l 318d 110 kW (150 PS)","series_code":"G20","year_from":"2022","year_to":"2024","years_label":"2022 – 2024","power_kw":110,"power_ps":150,"displacement_ccm":1995,"fuel_code":"diesel","fuel_label":"Diesel","drivetrain_code":"rear","drivetrain_label":"Heckantrieb","body_type_code":"sedan","body_type_label":"Limousine","pcd":"5x112","center_bore_mm":66.6,"oe_tires":[{"front":"225/50R17Y"},{"front":"225/50R17 98Y"}],"vsns":["00175"],"wheels_available":true},{"selection_id":"var_2022-110kw-hybrid-identity-0064c7bbdec19515","kind":"variant","label":"318d Limousine, 2,0l 110 kW (150 PS)","year_from":"2022","year_to":null,"years_label":"ab 2022","power_kw":110,"power_ps":150,"displacement_ccm":1995,"fuel_code":"mild_hybrid","fuel_label":"Mild-Hybrid","drivetrain_code":"rear","drivetrain_label":"Heckantrieb","body_type_code":"sedan","body_type_label":"Limousine","pcd":"5x112","center_bore_mm":66.6,"oe_tires":[{"front":"225/50R17 98Y"},{"front":"225/45R18 95Y"}],"vsns":["00175"],"wheels_available":true},{"selection_id":"var_g20-2024-110kw-diesel","kind":"variant","label":"318d Typ G20 Facelift 2024, 2,0l 318d 110 kW (150 PS)","series_code":"G20","year_from":"2024","year_to":null,"years_label":"ab 2024","power_kw":110,"power_ps":150,"displacement_ccm":1995,"fuel_code":"diesel","fuel_label":"Diesel","drivetrain_code":"rear","drivetrain_label":"Heckantrieb","body_type_code":"sedan","body_type_label":"Limousine","pcd":"5x112","center_bore_mm":66.6,"oe_tires":[{"front":"225/50R17Y"}],"wheels_available":true}],"configuration_count":2,"insurance":{"liability":21,"partial_comprehensive":26,"full_comprehensive":25,"history":{"liability":{"2022":19,"2023":19,"2024":20,"2025":20,"2026":20,"2027":21},"partial_comprehensive":{"2022":26,"2023":26,"2024":27,"2025":26,"2026":26,"2027":26},"full_comprehensive":{"2022":26,"2023":26,"2024":26,"2025":26,"2026":26,"2027":25}},"year":2027},"market":{"latest":[{"metric":"registered_stock","value":1861,"status":"published","unit":"vehicles","period":{"grain":"annual","start":"2026-01-01","end":"2026-01-01"},"scope":{"type":"hsn_tsn","key":"0005_DDL","label":"318d","brand":"BMW","tsn":"DDL","hsn_tsn_exact":true},"geography":{"type":"country","code":"DE","key":"DE"},"dimensions":{},"source":"official_statistics","source_family":"vehicle_market","quality":"official_exact","is_estimate":false}],"scope":"official_hsn_tsn_and_validated_trade_name_tsn"},"market_history":{"available":true,"scope":"official_hsn_tsn","hsn_tsn_exact":true,"registration_history":[{"year":2021,"registered":387},{"year":2022,"registered":931},{"year":2023,"registered":1216},{"year":2024,"registered":1551},{"year":2025,"registered":1732},{"year":2026,"registered":1861}],"registration_trend":{"year_over_year":{"change_pct":7.45,"from_year":2025,"to_year":2026},"average_per_year":{"change_pct":36.91,"from_year":2021,"to_year":2026}}},"safety":{"available":false,"scope":"validated_model","hsn_tsn_exact":false,"recall_count":0,"recalls":[],"reason":"no_validated_model_recall_match"},"environment":{"available":false,"scope":"no_safe_hsn_tsn_projection","hsn_tsn_exact":false,"latest":[],"reason":"no_exact_hsn_tsn_environment_fact"},"data_sheet":{"sheets":[{"vsn":"00038","type_approval_number":"e1*2007/46*1947*06","body_label":"Limousine - G3L (G20)","doors":5,"seats":5,"production":{"start_year":2020,"end_year":2022,"end_status":"documented"},"engine_label":"Mild-Hybrid","engine_code":"B47","fuel_code":"mild_hybrid","fuel_label":"Mild-Hybrid","drivetrain_code":"rear","drivetrain_label":"Heckantrieb","power_kw":110,"power_ps":150,"displacement_ccm":1995,"top_speed_kmh":224,"rated_speed_rpm":4000,"system_torque_nm":320,"combustion_torque_nm":320,"combustion_rated_speed_rpm":4000,"combustion_max_torque_speed_rpm":1500,"co2_wltp_combined_g_km":116,"length_cm":471,"width_cm":183,"height_cm":144,"curb_weight_kg":1615,"gross_weight_kg":2120,"axle_load_front_kg":995,"axle_load_rear_kg":1185,"towing_braked_kg":1600,"towing_unbraked_kg":750,"nose_weight_kg":75,"engine_oil_capacity_l":5.5,"coolant_capacity_l":7.7}],"facts":{"length_mm":{"status":"confirmed","values":[4709]},"width_mm":{"status":"confirmed","values":[1827]},"height_mm":{"status":"confirmed","values":[1435]},"wheelbase_mm":{"status":"confirmed","values":[2851]},"curb_weight_kg":{"status":"confirmed","values":[1615,1660]},"gross_weight_kg":{"status":"confirmed","values":[2120,2155]},"axle_load_front_kg":{"status":"confirmed","values":[995,1005]},"axle_load_rear_kg":{"status":"confirmed","values":[1185,1220]},"drivetrain":{"status":"confirmed","values":["RWD"]}}},"vehicle_image":{"available":true,"ambiguous":true,"delivery_ready":false,"vehicle_image_id":null,"label":null,"thumbnail":null,"body_match":null,"body_notice":null,"matches":[{"vehicle_image_id":"bmw-330e-g20","label":"BMW 330e (G20)","thumbnail":{"url":null,"width":320,"height":178,"bytes":7308,"format":"webp","mime_type":"image/webp","quality":86,"paint":"metallic_silver","variant":"vehicle_base"},"delivery_ready":false,"body_match":"exact","body_notice":null},{"vehicle_image_id":"bmw-3er-reihe-g20-g21-g80-g81-facelift-2","label":"BMW 3er Limousine (G20 Facelift)","thumbnail":{"url":null,"width":320,"height":178,"bytes":7086,"format":"webp","mime_type":"image/webp","quality":86,"paint":"metallic_silver","variant":"vehicle_base"},"delivery_ready":false,"body_match":"exact","body_notice":null}]},"available_sections":{"workshop":false,"market":true,"recalls":false}},"attribution":[{"source":"kba","publisher":"Kraftfahrt-Bundesamt (KBA)","license":{"name":"Datenlizenz Deutschland – Namensnennung – Version 2.0","id":"dl-de/by-2-0","url":"https://www.govdata.de/dl-de/by-2-0"},"datasets":[{"name":"FZ 6 – Bestand an Kraftfahrzeugen und Kraftfahrzeuganhängern nach Herstellern und Typen, Stand 01.01.2026","url":"https://data.gov.de/suche/daten/fz-6-2026-bestand-an-kraftfahrzeugen-und-kraftfahrzeuganhangern-nach-hersteller-und-typen-am-1-?ids=6ae58c67-8615-4417-85e3-fd05fbfae605"},{"name":"FZ Hersteller Handelsnamen Pkw","url":"https://data.gov.de/suche/daten/fz-hersteller-handelsnamen-pkw"},{"name":"KBA-Verzeichnis SV 4.2, Stand 15.08.2026","url":"https://www.kba.de/SharedDocs/Downloads/DE/SV/sv42_pdf.pdf"}],"note":"Daten verändert: eigene Berechnungen auf Grundlage von Daten des Kraftfahrt-Bundesamtes"}],"meta":{"api_version":2,"data_version":"2026-11-20.ea6570d403d7"}}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"X-RateLimit-Limit":{"$ref":"#/components/headers/MonthlyLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/MonthlyRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/MonthlyReset"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"}}},"304":{"description":"Unchanged response; use the previously cached body. No response body. Authenticated requests still count towards usage.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"X-RateLimit-Limit":{"$ref":"#/components/headers/MonthlyLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/MonthlyRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/MonthlyReset"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"405":{"$ref":"#/components/responses/E405"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"503":{"$ref":"#/components/responses/E503"}},"x-example-request":"/v2/vehicles/0005-DDL?include=insurance,market,market_history,safety,environment,data_sheet,vehicle_image,sections"}},"/v2/vehicle-list":{"get":{"tags":["Vehicles"],"summary":"Vehicles (HSN/TSN) of a brand, model or bolt pattern","description":"Call it from your server with your key and secret. One entry per published vehicle, ordered by HSN and TSN, in the same form as /v2/vehicles/{vehicle_id} without selections. Needs at least one filter. Brand and model match like /v2/insurance; pcd matches the stored bolt pattern exactly (case-insensitive).","parameters":[{"name":"brand","in":"query","required":false,"schema":{"type":"string","minLength":1},"description":"Brand name (known spellings of the same brand match, case and accents ignored) or brand id from /v2/brands."},{"name":"model","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":100},"description":"Model field of the vehicle contains this text (case and accents ignored)."},{"name":"model_id","in":"query","required":false,"schema":{"type":"string","pattern":"^[a-z0-9-]{1,120}$"},"description":"Model id from /v2/brands/{brand_id}/models; needs brand = the brand id."},{"name":"pcd","in":"query","required":false,"schema":{"type":"string","minLength":1},"description":"Bolt pattern, e.g. 5x112."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100},"description":"Page size (default 50)."},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"},"description":"Opaque cursor from meta.next_cursor."},{"name":"data_version","in":"query","required":false,"schema":{"type":"string"},"description":"Optional: fail with 409 if the active data release differs."},{"name":"If-None-Match","in":"header","required":false,"schema":{"type":"string"},"description":"ETag for the same request; unchanged: 304 without a body."}],"responses":{"200":{"description":"Vehicles.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Vehicle"}},"meta":{"$ref":"#/components/schemas/MetaSearch"},"attribution":{"$ref":"#/components/schemas/Attribution"}}},"example":{"data":[{"vehicle_id":"0005-BSI","hsn":"0005","tsn":"BSI","brand":"BMW","model":"Schrägheck - BMWi-1, i3","year_from":"2013","year_to":null,"years_label":"ab 2013","display":{"brand":"BMW","model":"i3","trim":"i3 (120 Ah)","series":"i3 (I01)","series_code":"I01"},"wheels":{"pcd":"5x112","pcd_status":"verified","center_bore_mm":66.6,"center_bore_status":"verified","thread":"M14X1.25","torque_nm":140,"fastener":"Radschrauben","fastener_code":"bolts"},"oe_tires":[{"front":"155/70R19Q"},{"front":"155/70R19 84Q","front_wheel":"5.0x19 ET43"},{"front":"155/70R19 88Q","front_wheel":"5.0x19 ET43"},{"front":"155/70R19 88Q","front_wheel":"5.0x19 ET28"}],"has_wheels":false}],"meta":{"api_version":2,"data_version":"2026-11-20.ea6570d403d7","total":726,"next_cursor":"eyJ2IjoiMjAyNi0xMS0yMC5lYTY1NzBkNDAzZDciLCJrIjoidmVoaWNsZXMiLCJpZCI6ImJyYW5kPWJtdyZtb2RlbD0mbW9kZWxfaWQ9JnBjZD01eDExMiIsInAiOiIwMDA1LUJTSSJ9"},"attribution":[{"source":"kba","publisher":"Kraftfahrt-Bundesamt (KBA)","license":{"name":"Datenlizenz Deutschland – Namensnennung – Version 2.0","id":"dl-de/by-2-0","url":"https://www.govdata.de/dl-de/by-2-0"},"datasets":[{"name":"FZ 6 – Bestand an Kraftfahrzeugen und Kraftfahrzeuganhängern nach Herstellern und Typen, Stand 01.01.2026","url":"https://data.gov.de/suche/daten/fz-6-2026-bestand-an-kraftfahrzeugen-und-kraftfahrzeuganhangern-nach-hersteller-und-typen-am-1-?ids=6ae58c67-8615-4417-85e3-fd05fbfae605"},{"name":"FZ Hersteller Handelsnamen Pkw","url":"https://data.gov.de/suche/daten/fz-hersteller-handelsnamen-pkw"},{"name":"KBA-Verzeichnis SV 4.2, Stand 15.08.2026","url":"https://www.kba.de/SharedDocs/Downloads/DE/SV/sv42_pdf.pdf"}],"note":"Daten verändert: eigene Berechnungen auf Grundlage von Daten des Kraftfahrt-Bundesamtes"}]}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"X-RateLimit-Limit":{"$ref":"#/components/headers/MonthlyLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/MonthlyRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/MonthlyReset"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"}}},"304":{"description":"Unchanged response; use the previously cached body. No response body. Authenticated requests still count towards usage.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"X-RateLimit-Limit":{"$ref":"#/components/headers/MonthlyLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/MonthlyRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/MonthlyReset"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"403":{"description":"Key inactive (subscription_inactive)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"$ref":"#/components/responses/E404"},"405":{"$ref":"#/components/responses/E405"},"409":{"$ref":"#/components/responses/E409"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"503":{"$ref":"#/components/responses/E503"}},"x-example-request":"/v2/vehicle-list?brand=bmw&pcd=5x112&limit=1"}},"/v2/insurance":{"get":{"tags":["Insurance"],"summary":"Insurance type classes of all vehicles of a brand or model","description":"Call it from your server with your key and secret. One entry per vehicle (HSN/TSN) that has insurance type classes, ordered by HSN and TSN. Needs brand and/or model. Values are the same as /v2/vehicles/{vehicle_id}?include=insurance.","parameters":[{"name":"brand","in":"query","required":false,"schema":{"type":"string","minLength":1},"description":"Brand name (as on the vehicle or in /v2/brands; known spellings of the same brand match, case and accents ignored) or brand id from /v2/brands."},{"name":"model","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":100},"description":"Model field of the vehicle contains this text (case and accents ignored)."},{"name":"model_id","in":"query","required":false,"schema":{"type":"string","pattern":"^[a-z0-9-]{1,120}$"},"description":"Model id from /v2/brands/{brand_id}/models; needs brand = the brand id. Matches all vehicles the navigation lists under this model."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100},"description":"Page size (default 50)."},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"},"description":"Opaque cursor from meta.next_cursor."},{"name":"data_version","in":"query","required":false,"schema":{"type":"string"},"description":"Optional: fail with 409 if the active data release differs."},{"name":"If-None-Match","in":"header","required":false,"schema":{"type":"string"},"description":"ETag for the same request; unchanged: 304 without a body."}],"responses":{"200":{"description":"Vehicles with insurance type classes.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/InsuranceListItem"}},"meta":{"$ref":"#/components/schemas/MetaSearch"},"attribution":{"$ref":"#/components/schemas/Attribution"}}},"example":{"data":[{"vehicle_id":"0005-503","hsn":"0005","tsn":"503","brand":"BMW","model":"Kombi - 3/C (E36)","insurance":{"liability":19,"partial_comprehensive":17,"full_comprehensive":11,"history":{"liability":{"2021":20,"2022":20,"2023":21,"2024":21,"2025":21,"2026":20,"2027":19},"partial_comprehensive":{"2021":14,"2022":15,"2023":15,"2024":16,"2025":16,"2026":16,"2027":17},"full_comprehensive":{"2021":10,"2022":10,"2023":10,"2024":11,"2025":11,"2026":11,"2027":11}},"year":2027}}],"meta":{"api_version":2,"data_version":"2026-11-20.ea6570d403d7","total":428,"next_cursor":"eyJ2IjoiMjAyNi0xMS0yMC5lYTY1NzBkNDAzZDciLCJrIjoiaW5zdXJhbmNlIiwiaWQiOiJicmFuZD1ibXcmbW9kZWw9Jm1vZGVsX2lkPTNlci1yZWloZSZwY2Q9IiwicCI6IjAwMDUtNTAzIn0"},"attribution":[{"source":"kba","publisher":"Kraftfahrt-Bundesamt (KBA)","license":{"name":"Datenlizenz Deutschland – Namensnennung – Version 2.0","id":"dl-de/by-2-0","url":"https://www.govdata.de/dl-de/by-2-0"},"datasets":[{"name":"FZ 6 – Bestand an Kraftfahrzeugen und Kraftfahrzeuganhängern nach Herstellern und Typen, Stand 01.01.2026","url":"https://data.gov.de/suche/daten/fz-6-2026-bestand-an-kraftfahrzeugen-und-kraftfahrzeuganhangern-nach-hersteller-und-typen-am-1-?ids=6ae58c67-8615-4417-85e3-fd05fbfae605"},{"name":"FZ Hersteller Handelsnamen Pkw","url":"https://data.gov.de/suche/daten/fz-hersteller-handelsnamen-pkw"},{"name":"KBA-Verzeichnis SV 4.2, Stand 15.08.2026","url":"https://www.kba.de/SharedDocs/Downloads/DE/SV/sv42_pdf.pdf"}],"note":"Daten verändert: eigene Berechnungen auf Grundlage von Daten des Kraftfahrt-Bundesamtes"}]}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"X-RateLimit-Limit":{"$ref":"#/components/headers/MonthlyLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/MonthlyRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/MonthlyReset"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"}}},"304":{"description":"Unchanged response; use the previously cached body. No response body. Authenticated requests still count towards usage.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"X-RateLimit-Limit":{"$ref":"#/components/headers/MonthlyLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/MonthlyRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/MonthlyReset"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"403":{"description":"Key inactive (subscription_inactive)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"$ref":"#/components/responses/E404"},"405":{"$ref":"#/components/responses/E405"},"409":{"$ref":"#/components/responses/E409"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"503":{"$ref":"#/components/responses/E503"}},"x-example-request":"/v2/insurance?brand=bmw&model_id=3er-reihe&limit=1"}},"/v2/vehicles/{vehicle_id}/technical":{"get":{"tags":["Vehicles"],"summary":"Technical profile per variant: dimensions, weights, towing, powertrain, engines with fluid capacities and axle loads","parameters":[{"name":"vehicle_id","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9]{4}-[A-Z0-9]{3}$"},"description":"HSN-TSN, e.g. 0005-DFY."},{"name":"selection","in":"query","required":false,"schema":{"type":"string"},"description":"Variant selection id (var_…) or superseded key (als_…) from the vehicle; configurations are not supported here. Missing wheel evidence does not affect this endpoint."},{"name":"If-None-Match","in":"header","required":false,"schema":{"type":"string"},"description":"ETag for the same request; unchanged: 304 without a body."}],"responses":{"200":{"description":"Technical profile.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/VehicleTechnical"},"meta":{"$ref":"#/components/schemas/MetaWheels"},"attribution":{"$ref":"#/components/schemas/Attribution"}}},"example":{"data":{"vehicle_id":"0005-DDL","brand":"BMW","model":"Limousine - G3L (G20)","wheel_mounting":{"pcd":"5x112","pcd_status":"verified","center_bore_mm":66.6,"center_bore_status":"verified","thread":"M14X1.25","torque_nm":140,"fastener":"Radschrauben","fastener_code":"bolts"},"engines_unavailable":"configuration_evidence_required","variants":[{"selection_id":"var_g20-2019-110kw-diesel","brand":"BMW","model":"Limousine - G3L (G20)","label":"Limousine - G3L (G20)","body_type_code":"sedan","body_type_label":"Limousine","fuel_code":"mild_hybrid","fuel_label":"Mild-Hybrid","drivetrain_code":"rear","drivetrain_label":"Heckantrieb","year_from":"2020","year_to":"2022","years_label":"2020 – 2022","body":{"doors":5,"seats":5},"dimensions":{"length_mm":4710,"width_mm":1830,"height_mm":1440},"powertrain":{"power_kw":110,"power_ps":150,"displacement_ccm":1995},"weights":{"curb_kg":1615,"gross_kg":2120},"towing":{"braked_kg":1600,"unbraked_kg":750,"nose_weight_kg":75},"engine":{"type":"Mild-Hybrid","codes":["B47"],"codes_normalized":["B47"]},"completeness":28}],"safety_note":"Use the exact variant and verify manufacturer documentation before service."},"meta":{"api_version":2,"data_version":"2026-11-20.ea6570d403d7","selection":{"id":"var_g20-2019-110kw-diesel","type":"variant","status":"applied","applied_ids":["var_g20-2019-110kw-diesel"]}},"attribution":[{"source":"kba","publisher":"Kraftfahrt-Bundesamt (KBA)","license":{"name":"Datenlizenz Deutschland – Namensnennung – Version 2.0","id":"dl-de/by-2-0","url":"https://www.govdata.de/dl-de/by-2-0"},"datasets":[{"name":"FZ 6 – Bestand an Kraftfahrzeugen und Kraftfahrzeuganhängern nach Herstellern und Typen, Stand 01.01.2026","url":"https://data.gov.de/suche/daten/fz-6-2026-bestand-an-kraftfahrzeugen-und-kraftfahrzeuganhangern-nach-hersteller-und-typen-am-1-?ids=6ae58c67-8615-4417-85e3-fd05fbfae605"},{"name":"FZ Hersteller Handelsnamen Pkw","url":"https://data.gov.de/suche/daten/fz-hersteller-handelsnamen-pkw"},{"name":"KBA-Verzeichnis SV 4.2, Stand 15.08.2026","url":"https://www.kba.de/SharedDocs/Downloads/DE/SV/sv42_pdf.pdf"}],"note":"Daten verändert: eigene Berechnungen auf Grundlage von Daten des Kraftfahrt-Bundesamtes"}]}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"X-RateLimit-Limit":{"$ref":"#/components/headers/MonthlyLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/MonthlyRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/MonthlyReset"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"}}},"304":{"description":"Unchanged response; use the previously cached body. No response body. Authenticated requests still count towards usage.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"X-RateLimit-Limit":{"$ref":"#/components/headers/MonthlyLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/MonthlyRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/MonthlyReset"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"405":{"$ref":"#/components/responses/E405"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"503":{"$ref":"#/components/responses/E503"}},"x-example-request":"/v2/vehicles/0005-DDL/technical?selection=var_g20-2019-110kw-diesel"}},"/v2/vehicles/{vehicle_id}/workshop-profile":{"get":{"tags":["Vehicles"],"summary":"Workshop profile: engines with fluid capacities, axle loads and wheel mounting per variant, or the documented values of one EU configuration","description":"Same content as the V1 workshop profile. Without a selection or with a variant: profile_basis variant, the technical profile of /technical. With an EU configuration (cfg_…): profile_basis configuration, the configuration with its displacement, axle loads and documented fields. Missing evidence is never an error: engines_unavailable or profile_unavailable says why.","parameters":[{"name":"vehicle_id","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9]{4}-[A-Z0-9]{3}$"},"description":"HSN-TSN, e.g. 0005-DFY."},{"name":"selection","in":"query","required":false,"schema":{"type":"string"},"description":"Variant selection id (var_…), superseded key or EU configuration id (cfg_…) from the vehicle. Missing wheel evidence does not affect this endpoint."},{"name":"If-None-Match","in":"header","required":false,"schema":{"type":"string"},"description":"ETag for the same request; unchanged: 304 without a body."}],"responses":{"200":{"description":"Workshop profile.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/VehicleWorkshopProfile"},"meta":{"$ref":"#/components/schemas/MetaWheels"},"attribution":{"$ref":"#/components/schemas/Attribution"}}},"example":{"data":{"vehicle_id":"0005-DDL","brand":"BMW","model":"Limousine - G3L (G20)","profile_basis":"configuration","configuration":{"selection_id":"cfg_06f3fb005822ea221082aefda8f355c919a436823742223e7effc48e627025df","kind":"configuration","type_approval":"e1*2007/46*1947*06","approval_base":"e1*2007/46*1947","approval_extension":"06","type":"G3L","variant":"5V38","version":"IAA500B0","variant_selection_id":"var_g20-2019-110kw-diesel","technical_observations":[{"field":"body_type","value":"sedan","label":"Limousine","measurement_basis":"reported_body_type"},{"field":"braked_trailer_mass","value":1600,"unit":"kg","measurement_basis":"reported_limit"},{"field":"displacement","value":1995,"unit":"cm3","measurement_basis":"engine_displacement"}],"wheels_available":true},"configuration_profile":{"displacement_ccm":1995,"axle_loads":{"front_kg":995,"rear_kg":1185},"documented_fields":["body_type","braked_trailer_mass","displacement","drive_layout","empty_mass","front_axle_load","height","length","maximum_mass","power","propulsion","rear_axle_load","unbraked_trailer_mass","vertical_load","wheelbase","width"]},"safety_note":"Use the exact variant and verify manufacturer documentation before service."},"meta":{"api_version":2,"data_version":"2026-11-20.ea6570d403d7","selection":{"id":"cfg_06f3fb005822ea221082aefda8f355c919a436823742223e7effc48e627025df","type":"configuration","status":"applied","applied_ids":["cfg_06f3fb005822ea221082aefda8f355c919a436823742223e7effc48e627025df"]}},"attribution":[{"source":"kba","publisher":"Kraftfahrt-Bundesamt (KBA)","license":{"name":"Datenlizenz Deutschland – Namensnennung – Version 2.0","id":"dl-de/by-2-0","url":"https://www.govdata.de/dl-de/by-2-0"},"datasets":[{"name":"FZ 6 – Bestand an Kraftfahrzeugen und Kraftfahrzeuganhängern nach Herstellern und Typen, Stand 01.01.2026","url":"https://data.gov.de/suche/daten/fz-6-2026-bestand-an-kraftfahrzeugen-und-kraftfahrzeuganhangern-nach-hersteller-und-typen-am-1-?ids=6ae58c67-8615-4417-85e3-fd05fbfae605"},{"name":"FZ Hersteller Handelsnamen Pkw","url":"https://data.gov.de/suche/daten/fz-hersteller-handelsnamen-pkw"},{"name":"KBA-Verzeichnis SV 4.2, Stand 15.08.2026","url":"https://www.kba.de/SharedDocs/Downloads/DE/SV/sv42_pdf.pdf"}],"note":"Daten verändert: eigene Berechnungen auf Grundlage von Daten des Kraftfahrt-Bundesamtes"}]}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"X-RateLimit-Limit":{"$ref":"#/components/headers/MonthlyLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/MonthlyRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/MonthlyReset"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"}}},"304":{"description":"Unchanged response; use the previously cached body. No response body. Authenticated requests still count towards usage.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"X-RateLimit-Limit":{"$ref":"#/components/headers/MonthlyLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/MonthlyRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/MonthlyReset"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"405":{"$ref":"#/components/responses/E405"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"503":{"$ref":"#/components/responses/E503"}},"x-example-request":"/v2/vehicles/0005-DDL/workshop-profile?selection=cfg_06f3fb005822ea221082aefda8f355c919a436823742223e7effc48e627025df"}},"/v2/vehicles/compare":{"get":{"tags":["Vehicles"],"summary":"Compare 2–5 vehicles: variants with dimensions, weights, towing, powertrain and engine","description":"Same content as the V1 vehicle comparison. Vehicles in the order of ids; an unknown vehicle gives an entry with not_found. One call counts as one request, whatever the number of vehicles.","parameters":[{"name":"ids","in":"query","required":true,"schema":{"type":"string"},"description":"Two to five different vehicle ids (HSN-TSN), comma-separated, e.g. 0005-DDL,0603-BMN."},{"name":"selections","in":"query","required":false,"schema":{"type":"string"},"description":"Optional: one variant per vehicle as <vehicle_id>:<selection_id> pairs, comma-separated, e.g. 0005-DDL:var_g20-2019-110kw-diesel. Each vehicle must be listed in ids; configurations are not supported here."},{"name":"If-None-Match","in":"header","required":false,"schema":{"type":"string"},"description":"ETag for the same request; unchanged: 304 without a body."}],"responses":{"200":{"description":"Comparison.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/VehicleCompareItem"}},"meta":{"$ref":"#/components/schemas/MetaCompare"},"attribution":{"$ref":"#/components/schemas/Attribution"}}},"example":{"data":[{"vehicle_id":"0005-DDL","brand":"BMW","model":"Limousine - G3L (G20)","variants":[{"selection_id":"var_g20-2019-110kw-diesel","brand":"BMW","model":"Limousine - G3L (G20)","label":"Limousine - G3L (G20)","body_type_code":"sedan","body_type_label":"Limousine","fuel_code":"mild_hybrid","fuel_label":"Mild-Hybrid","drivetrain_code":"rear","drivetrain_label":"Heckantrieb","year_from":"2020","year_to":"2022","years_label":"2020 – 2022","body":{"doors":5,"seats":5},"dimensions":{"length_mm":4710,"width_mm":1830,"height_mm":1440},"powertrain":{"power_kw":110,"power_ps":150,"displacement_ccm":1995},"weights":{"curb_kg":1615,"gross_kg":2120},"towing":{"braked_kg":1600,"unbraked_kg":750,"nose_weight_kg":75},"engine":{"type":"Mild-Hybrid","codes":["B47"],"codes_normalized":["B47"]},"completeness":28}]},{"vehicle_id":"0005-BLJ","brand":"BMW","model":"Schrägheck - 1K4 (F20)","variants":[{"selection_id":"var_2011-120kw-diesel","brand":"BMW","model":"Schrägheck - 1K4 (F20)","label":"120d","body_type_code":"hatchback","body_type_label":"Schrägheck","fuel_code":"diesel","fuel_label":"Diesel","drivetrain_code":"rear","drivetrain_label":"Heckantrieb","year_from":"2011","years_label":"ab 2011","body":{"doors":5,"seats":5},"dimensions":{"length_mm":4330,"width_mm":1770,"height_mm":1420},"powertrain":{"power_kw":120,"power_ps":163,"displacement_ccm":1995},"weights":{"curb_kg":1505,"gross_kg":1985},"towing":{"braked_kg":1500,"unbraked_kg":710,"nose_weight_kg":75},"engine":{"type":"Dieselmotor","codes":["B47"],"codes_normalized":["B47"]},"completeness":27}]}],"meta":{"api_version":2,"data_version":"2026-11-20.ea6570d403d7","comparison_basis":"documented_vehicle_variants","selections":[{"vehicle_id":"0005-DDL","id":"var_g20-2019-110kw-diesel","type":"variant","status":"applied","applied_ids":["var_g20-2019-110kw-diesel"]}]},"attribution":[{"source":"kba","publisher":"Kraftfahrt-Bundesamt (KBA)","license":{"name":"Datenlizenz Deutschland – Namensnennung – Version 2.0","id":"dl-de/by-2-0","url":"https://www.govdata.de/dl-de/by-2-0"},"datasets":[{"name":"FZ 6 – Bestand an Kraftfahrzeugen und Kraftfahrzeuganhängern nach Herstellern und Typen, Stand 01.01.2026","url":"https://data.gov.de/suche/daten/fz-6-2026-bestand-an-kraftfahrzeugen-und-kraftfahrzeuganhangern-nach-hersteller-und-typen-am-1-?ids=6ae58c67-8615-4417-85e3-fd05fbfae605"},{"name":"FZ Hersteller Handelsnamen Pkw","url":"https://data.gov.de/suche/daten/fz-hersteller-handelsnamen-pkw"},{"name":"KBA-Verzeichnis SV 4.2, Stand 15.08.2026","url":"https://www.kba.de/SharedDocs/Downloads/DE/SV/sv42_pdf.pdf"}],"note":"Daten verändert: eigene Berechnungen auf Grundlage von Daten des Kraftfahrt-Bundesamtes"}]}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"X-RateLimit-Limit":{"$ref":"#/components/headers/MonthlyLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/MonthlyRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/MonthlyReset"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"}}},"304":{"description":"Unchanged response; use the previously cached body. No response body. Authenticated requests still count towards usage.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"X-RateLimit-Limit":{"$ref":"#/components/headers/MonthlyLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/MonthlyRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/MonthlyReset"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"403":{"$ref":"#/components/responses/E403"},"405":{"$ref":"#/components/responses/E405"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"503":{"$ref":"#/components/responses/E503"}},"x-example-request":"/v2/vehicles/compare?ids=0005-DDL,0005-BLJ&selections=0005-DDL%3Avar_g20-2019-110kw-diesel"}},"/v2/vehicles/{vehicle_id}/configurations":{"get":{"tags":["Vehicles"],"summary":"EU configurations of a vehicle","parameters":[{"name":"vehicle_id","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9]{4}-[A-Z0-9]{3}$"},"description":"HSN-TSN, e.g. 0005-DFY."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100},"description":"Page size (default 50)."},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"},"description":"Opaque cursor from meta.next_cursor."},{"name":"data_version","in":"query","required":false,"schema":{"type":"string"},"description":"Optional: fail with 409 if the active data release differs."},{"name":"include","in":"query","required":false,"schema":{"type":"string","enum":["registrations"]},"description":"registrations: annual registration statistics per configuration (registration_observations). Opt-in because a single configuration can carry several megabytes of statistics; pages are limited to about 1.5 MB of statistics."},{"name":"If-None-Match","in":"header","required":false,"schema":{"type":"string"},"description":"ETag for the same request; unchanged: 304 without a body."}],"responses":{"200":{"description":"Configurations.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Selection"}},"meta":{"$ref":"#/components/schemas/MetaPaged"}}},"example":{"data":[{"selection_id":"cfg_06f3fb005822ea221082aefda8f355c919a436823742223e7effc48e627025df","kind":"configuration","type_approval":"e1*2007/46*1947*06","approval_base":"e1*2007/46*1947","approval_extension":"06","type":"G3L","variant":"5V38","version":"IAA500B0","variant_selection_id":"var_g20-2019-110kw-diesel","technical_observations":[{"field":"body_type","value":"sedan","label":"Limousine","measurement_basis":"reported_body_type"},{"field":"braked_trailer_mass","value":1600,"unit":"kg","measurement_basis":"reported_limit"},{"field":"displacement","value":1995,"unit":"cm3","measurement_basis":"engine_displacement"}],"wheels_available":true}],"meta":{"api_version":2,"data_version":"2026-11-20.ea6570d403d7","next_cursor":"eyJ2IjoiMjAyNi0xMS0yMC5lYTY1NzBkNDAzZDciLCJrIjoiY29uZmlndXJhdGlvbnMiLCJpZCI6IjAwMDUtRERMIiwicCI6NH0"},"attribution":[{"source":"kba","publisher":"Kraftfahrt-Bundesamt (KBA)","license":{"name":"Datenlizenz Deutschland – Namensnennung – Version 2.0","id":"dl-de/by-2-0","url":"https://www.govdata.de/dl-de/by-2-0"},"datasets":[{"name":"FZ 6 – Bestand an Kraftfahrzeugen und Kraftfahrzeuganhängern nach Herstellern und Typen, Stand 01.01.2026","url":"https://data.gov.de/suche/daten/fz-6-2026-bestand-an-kraftfahrzeugen-und-kraftfahrzeuganhangern-nach-hersteller-und-typen-am-1-?ids=6ae58c67-8615-4417-85e3-fd05fbfae605"},{"name":"FZ Hersteller Handelsnamen Pkw","url":"https://data.gov.de/suche/daten/fz-hersteller-handelsnamen-pkw"},{"name":"KBA-Verzeichnis SV 4.2, Stand 15.08.2026","url":"https://www.kba.de/SharedDocs/Downloads/DE/SV/sv42_pdf.pdf"}],"note":"Daten verändert: eigene Berechnungen auf Grundlage von Daten des Kraftfahrt-Bundesamtes"}]}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"X-RateLimit-Limit":{"$ref":"#/components/headers/MonthlyLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/MonthlyRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/MonthlyReset"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"}}},"304":{"description":"Unchanged response; use the previously cached body. No response body. Authenticated requests still count towards usage.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"X-RateLimit-Limit":{"$ref":"#/components/headers/MonthlyLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/MonthlyRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/MonthlyReset"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"405":{"$ref":"#/components/responses/E405"},"409":{"$ref":"#/components/responses/E409"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"503":{"$ref":"#/components/responses/E503"}},"x-example-request":"/v2/vehicles/0005-DDL/configurations?limit=1"}},"/v2/vehicles/{vehicle_id}/wheels":{"get":{"tags":["Wheels on vehicle"],"summary":"Wheel offers for a vehicle","parameters":[{"name":"vehicle_id","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9]{4}-[A-Z0-9]{3}$"},"description":"HSN-TSN, e.g. 0005-DFY."},{"name":"selection","in":"query","required":false,"schema":{"type":"string"},"description":"Selection id from the vehicle: var_… (variant), cfg_… (EU configuration) or als_… (superseded key with several successors). When no wheel statement is available for the vehicle or the selection (selections[].wheels_available false), the answer is 200 with an empty list, meta.wheels_available false and meta.unavailable_reason."},{"name":"vsn","in":"query","required":false,"schema":{"type":"string","pattern":"^[A-Za-z0-9]{5}[A-Za-z0-9-]?$"},"description":"VSN from field 2.2 of the registration certificate (positions 4–8, optionally with the check digit). Preselects the variant when exactly one variant of the vehicle carries this VSN (as selection=var_…); otherwise the result is the one without selection and meta.vsn_selection says why. A sent selection takes precedence. 00000 means the version cannot be determined."},{"name":"wheel_code","in":"query","required":false,"schema":{"type":"string"},"description":"Comma-separated, up to 50."},{"name":"brand","in":"query","required":false,"schema":{"type":"string","minLength":1},"description":"Wheel brand as in the wheel catalog (/v2/wheels), case-insensitive. Other names of the same brand match too (MM-Concepts = MM-Wheels). Offers whose wheel is not in the catalog never match."},{"name":"diameter_inch","in":"query","required":false,"schema":{"type":"number"},"description":"Rim diameter."},{"name":"et_mm","in":"query","required":false,"schema":{"type":"number"},"description":"Offset (ET) in mm."},{"name":"pcd","in":"query","required":false,"schema":{"type":"string","minLength":1},"description":"Bolt pattern, e.g. 5x112 (case-insensitive)."},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["no_registration","registration_required","unknown","not_fitting"]},"description":"Only offers with this status. For a shop list of wheels that fit, use status=no_registration (plus status=registration_required for wheels that need an inspection entry), or sort=status."},{"name":"tire_size","in":"query","required":false,"schema":{"type":"string"},"description":"Tire size, e.g. 225/45R18."},{"name":"view","in":"query","required":false,"schema":{"type":"string","enum":["summary","full"]},"description":"summary (default) or full with tires, tire pairs, sets and obligation texts."},{"name":"sort","in":"query","required":false,"schema":{"type":"string","enum":["wheel_code","status"]},"description":"wheel_code (default): by wheel code, diameter and offer. status: fitting first (no_registration, registration_required, unknown, not_fitting), within a status like wheel_code. The cursor belongs to the sort order."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100},"description":"Page size (default 50, with view=full 20)."},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"},"description":"Opaque cursor from meta.next_cursor."},{"name":"data_version","in":"query","required":false,"schema":{"type":"string"},"description":"Optional: fail with 409 if the active data release differs."},{"name":"If-None-Match","in":"header","required":false,"schema":{"type":"string"},"description":"ETag for the same request; unchanged: 304 without a body."}],"responses":{"200":{"description":"Offers.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Offer"}},"meta":{"$ref":"#/components/schemas/MetaWheels"},"included":{"$ref":"#/components/schemas/Included"},"attribution":{"$ref":"#/components/schemas/Attribution"}}},"example":{"data":[{"offer_id":"off_824935a237dbd7f2379db58d","wheel_code":"AC523","width_inch":8,"diameter_inch":18,"et_mm":29.5,"pcd":"5x112","center_bore_mm":66.6,"axle":"both","status":"no_registration","reason":"equipment_conditions_apply","match":"vehicle","document_ids":["doc_593118da1f046693d9c90164"],"centering":{"status":"direct_nominal","vehicle_bore_mm":66.6,"wheel_bore_mm":66.7},"tire_combination":"restricted_pairs","tire_sizes":["225/45R18","235/40R18","245/40R18"]},{"offer_id":"off_3eb75e5fe930ed12148af382","wheel_code":"AC523","width_inch":8.5,"diameter_inch":19,"et_mm":30,"pcd":"5x112","center_bore_mm":66.6,"axle":"both","status":"no_registration","reason":"equipment_conditions_apply","match":"vehicle","document_ids":["doc_a771e7ffb951eb0a40a39356"],"centering":{"status":"direct_nominal","vehicle_bore_mm":66.6,"wheel_bore_mm":66.7},"tire_combination":"restricted_pairs","tire_sizes":["225/40R19","235/35R19","245/35R19"]}],"meta":{"api_version":2,"data_version":"2026-11-20.ea6570d403d7","selection":{"id":null,"type":null,"status":"none"},"wheels_available":true,"total":278,"next_cursor":"eyJ2IjoiMjAyNi0xMS0yMC5lYTY1NzBkNDAzZDciLCJrIjoid2hlZWxzX3N0YXR1cyIsImlkIjoiMDAwNS1EREwiLCJwIjoiMHxBQzUyM3wwMDAwMTl8b2ZmXzNlYjc1ZTVmZTkzMGVkMTIxNDhhZjM4MiJ9"},"attribution":[{"source":"kba","publisher":"Kraftfahrt-Bundesamt (KBA)","license":{"name":"Datenlizenz Deutschland – Namensnennung – Version 2.0","id":"dl-de/by-2-0","url":"https://www.govdata.de/dl-de/by-2-0"},"datasets":[{"name":"FZ 6 – Bestand an Kraftfahrzeugen und Kraftfahrzeuganhängern nach Herstellern und Typen, Stand 01.01.2026","url":"https://data.gov.de/suche/daten/fz-6-2026-bestand-an-kraftfahrzeugen-und-kraftfahrzeuganhangern-nach-hersteller-und-typen-am-1-?ids=6ae58c67-8615-4417-85e3-fd05fbfae605"},{"name":"FZ Hersteller Handelsnamen Pkw","url":"https://data.gov.de/suche/daten/fz-hersteller-handelsnamen-pkw"},{"name":"KBA-Verzeichnis SV 4.2, Stand 15.08.2026","url":"https://www.kba.de/SharedDocs/Downloads/DE/SV/sv42_pdf.pdf"}],"note":"Daten verändert: eigene Berechnungen auf Grundlage von Daten des Kraftfahrt-Bundesamtes"}]}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"X-RateLimit-Limit":{"$ref":"#/components/headers/MonthlyLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/MonthlyRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/MonthlyReset"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"}}},"304":{"description":"Unchanged response; use the previously cached body. No response body. Authenticated requests still count towards usage.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"X-RateLimit-Limit":{"$ref":"#/components/headers/MonthlyLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/MonthlyRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/MonthlyReset"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"405":{"$ref":"#/components/responses/E405"},"409":{"$ref":"#/components/responses/E409"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"503":{"$ref":"#/components/responses/E503"}},"x-example-request":"/v2/vehicles/0005-DDL/wheels?sort=status&limit=2"}},"/v2/vehicles/{vehicle_id}/wheels/{wheel_code}":{"get":{"tags":["Wheels on vehicle"],"summary":"One wheel on a vehicle (all offsets and documents)","parameters":[{"name":"vehicle_id","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9]{4}-[A-Z0-9]{3}$"},"description":"HSN-TSN, e.g. 0005-DFY."},{"name":"wheel_code","in":"path","required":true,"schema":{"type":"string"},"description":"Wheel code."},{"name":"selection","in":"query","required":false,"schema":{"type":"string"},"description":"Selection id."},{"name":"vsn","in":"query","required":false,"schema":{"type":"string","pattern":"^[A-Za-z0-9]{5}[A-Za-z0-9-]?$"},"description":"VSN from field 2.2 of the registration certificate (positions 4–8, optionally with the check digit). Preselects the variant when exactly one variant of the vehicle carries this VSN (as selection=var_…); otherwise the result is the one without selection and meta.vsn_selection says why. A sent selection takes precedence. 00000 means the version cannot be determined."},{"name":"diameter_inch","in":"query","required":false,"schema":{"type":"number"},"description":"Rim diameter."},{"name":"et_mm","in":"query","required":false,"schema":{"type":"number"},"description":"Offset (ET) in mm."},{"name":"pcd","in":"query","required":false,"schema":{"type":"string","minLength":1},"description":"Bolt pattern, e.g. 5x112 (case-insensitive)."},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["no_registration","registration_required","unknown","not_fitting"]},"description":"Offer status."},{"name":"tire_size","in":"query","required":false,"schema":{"type":"string"},"description":"Tire size, e.g. 225/45R18."},{"name":"view","in":"query","required":false,"schema":{"type":"string","enum":["summary","full"]},"description":"Accepted for symmetry with /wheels; this endpoint always answers like view=full."},{"name":"data_version","in":"query","required":false,"schema":{"type":"string"},"description":"Optional: fail with 409 if the active data release differs."},{"name":"If-None-Match","in":"header","required":false,"schema":{"type":"string"},"description":"ETag for the same request; unchanged: 304 without a body."}],"responses":{"200":{"description":"Offers of one wheel.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Offer"}},"meta":{"$ref":"#/components/schemas/MetaWheels"},"included":{"$ref":"#/components/schemas/Included"},"attribution":{"$ref":"#/components/schemas/Attribution"}}},"example":{"data":[{"offer_id":"off_a3038a46e24d0bf988d7c713","wheel_code":"WH43","width_inch":8.5,"diameter_inch":20,"et_mm":30,"pcd":"5x112","center_bore_mm":66.6,"axle":"both","status":"no_registration","reason":"equipment_conditions_apply","match":"vehicle","document_ids":["doc_5111858fa9ea1b194fdbb179"],"centering":{"status":"direct_nominal","vehicle_bore_mm":66.6,"wheel_bore_mm":66.7},"tire_combination":"restricted_pairs","tires":[{"size":"225/35R20","axle":"both","status":"no_registration","power_kw_min":85,"power_kw_max":210,"obligations":["A12","A14","A21","A57","LIM","NOP","S01","T90","V20"],"reason":"equipment_conditions_apply"},{"size":"255/30R20","axle":"rear","status":"registration_required","power_kw_min":85,"power_kw_max":210,"obligations":["A01","A12","A14","A21","A57","K2A","K2B","LIM","NOP","R03","S01","T92","V20"],"reason":"registration_required","requires_bodywork":true}],"allowed_pairs":[{"front_tire":"225/35R20","rear_tire":"255/30R20","obligation":"V20"}]},{"offer_id":"off_be2396b4805a7966a6130759","wheel_code":"WH43","width_inch":9,"diameter_inch":20,"et_mm":40,"pcd":"5x112","center_bore_mm":66.6,"axle":"rear","status":"no_registration","reason":"equipment_conditions_apply","match":"vehicle","document_ids":["doc_74e6ccb64dc339abfd5303ed"],"centering":{"status":"direct_nominal","vehicle_bore_mm":66.6,"wheel_bore_mm":66.7},"tire_combination":"single","tires":[{"size":"255/30R20","axle":"rear","status":"no_registration","power_kw_min":85,"power_kw_max":210,"obligations":["A12","A14","A21","A57","HA2","LIM","NOP","R03","S01","T92","V20"],"reason":"equipment_conditions_apply"},{"size":"265/30R20","axle":"rear","status":"registration_required","power_kw_min":85,"power_kw_max":210,"obligations":["A01","A12","A14","A21","A57","HA2","K2B","LIM","NOP","R03","S01","T94","V20"],"reason":"registration_required","requires_bodywork":true}]}],"meta":{"api_version":2,"data_version":"2026-11-20.ea6570d403d7","selection":{"id":null,"type":null,"status":"none"},"wheels_available":true,"next_cursor":null},"included":{"sets":[{"set_id":"set_45d4a34719415dfeea19","document_id":"doc_74e6ccb64dc339abfd5303ed","front_offer_id":"off_a3038a46e24d0bf988d7c713","rear_offer_id":"off_be2396b4805a7966a6130759","front_tire":"225/35R20","rear_tire":"255/30R20","front_status":"no_registration","rear_status":"no_registration","status":"no_registration","obligations":["V20","VN1","VN2"]}],"documents":{"doc_5111858fa9ea1b194fdbb179":{"approval_type":"KBA","approval_number":"55675*01","obligations":{"A01":"Nach Durchführung der Technischen Änderung ist das Fahrzeug unter Vorlage der vorliegenden ABE unverzüglich einem amtlich anerkannten Sachverständigen oder Prüfer für den Kraftfahrzeugverkehr oder einem Prüfingenieur einer Überwachungsorganisation nach Nummer 4 der Anlage VIIIb zur StVZO zur Durchführung und Bestätigung der in der ABE vorgeschriebenen Änderungsabnahme vorzuführen.","A12":"Die Verwendung von Schneeketten ist nicht zulässig.","A14":"Zum Auswuchten der Räder dürfen an der Felgenaußenseite nur Klebegewichte unterhalb der Felgenschulter oder des Tiefbettes angebracht werden. Bei Anbringung der Klebegewichte im Felgenbett ist auf einen Mindestabstand von 2 mm zum Bremssattel zu achten.","A21":"Es sind nur schlauchlose Reifen zulässig. Werden keine Ventile mit TPMS-Sensoren verwendet, sind Metallschraubventile mit Befestigung von außen zulässig. Bei Verwendung bis zu einer Höchstgeschwindigkeit von 210 km/h (bauartbedingte Höchstgeschwindigkeit, Fzg.-Schein, Ziff. 6 bzw. Zulassungsbescheinigung Feld T oder bei Verwendung von Winterreifen mit Geschwindigkeitssymbol Q, R, S, T oder H) sind auch Gummiventile zulässig. Werden Ventile mit TPMS-Sensoren verwendet, so sind die Hinweise und Vorgaben der Hersteller zu beachten. Die Ventile und Sensoren müssen für den vorgeschriebenen Luftdruck und die Höchstgeschwindigkeit geeignet sein. Die Ventile müssen den Normen E.T.R.T.O., DIN oder Tire and Rim entsprechen und dürfen nicht über den Felgenrand hinausragen."}},"doc_74e6ccb64dc339abfd5303ed":{"approval_type":"KBA","approval_number":"55675*03","obligations":{"A01":"Nach Durchführung der Technischen Änderung ist das Fahrzeug unter Vorlage der vorliegenden ABE unverzüglich einem amtlich anerkannten Sachverständigen oder Prüfer für den Kraftfahrzeugverkehr oder einem Prüfingenieur einer Überwachungsorganisation nach Nummer 4 der Anlage VIIIb zur StVZO zur Durchführung und Bestätigung der in der ABE vorgeschriebenen Änderungsabnahme vorzuführen.","A12":"Die Verwendung von Schneeketten ist nicht zulässig.","A14":"Zum Auswuchten der Räder dürfen an der Felgenaußenseite nur Klebegewichte unterhalb der Felgenschulter oder des Tiefbettes angebracht werden. Bei Anbringung der Klebegewichte im Felgenbett ist auf einen Mindestabstand von 2 mm zum Bremssattel zu achten.","A21":"Es sind nur schlauchlose Reifen zulässig. Werden keine Ventile mit TPMS-Sensoren verwendet, sind Metallschraubventile mit Befestigung von außen zulässig. Bei Verwendung bis zu einer Höchstgeschwindigkeit von 210 km/h (bauartbedingte Höchstgeschwindigkeit, Fzg.-Schein, Ziff. 6 bzw. Zulassungsbescheinigung Feld T oder bei Verwendung von Winterreifen mit Geschwindigkeitssymbol Q, R, S, T oder H) sind auch Gummiventile zulässig. Werden Ventile mit TPMS-Sensoren verwendet, so sind die Hinweise und Vorgaben der Hersteller zu beachten. Die Ventile und Sensoren müssen für den vorgeschriebenen Luftdruck und die Höchstgeschwindigkeit geeignet sein. Die Ventile müssen den Normen E.T.R.T.O., DIN oder Tire and Rim entsprechen und dürfen nicht über den Felgenrand hinausragen."}}}},"attribution":[{"source":"kba","publisher":"Kraftfahrt-Bundesamt (KBA)","license":{"name":"Datenlizenz Deutschland – Namensnennung – Version 2.0","id":"dl-de/by-2-0","url":"https://www.govdata.de/dl-de/by-2-0"},"datasets":[{"name":"FZ 6 – Bestand an Kraftfahrzeugen und Kraftfahrzeuganhängern nach Herstellern und Typen, Stand 01.01.2026","url":"https://data.gov.de/suche/daten/fz-6-2026-bestand-an-kraftfahrzeugen-und-kraftfahrzeuganhangern-nach-hersteller-und-typen-am-1-?ids=6ae58c67-8615-4417-85e3-fd05fbfae605"},{"name":"FZ Hersteller Handelsnamen Pkw","url":"https://data.gov.de/suche/daten/fz-hersteller-handelsnamen-pkw"},{"name":"KBA-Verzeichnis SV 4.2, Stand 15.08.2026","url":"https://www.kba.de/SharedDocs/Downloads/DE/SV/sv42_pdf.pdf"}],"note":"Daten verändert: eigene Berechnungen auf Grundlage von Daten des Kraftfahrt-Bundesamtes"}]}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"X-RateLimit-Limit":{"$ref":"#/components/headers/MonthlyLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/MonthlyRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/MonthlyReset"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"}}},"304":{"description":"Unchanged response; use the previously cached body. No response body. Authenticated requests still count towards usage.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"X-RateLimit-Limit":{"$ref":"#/components/headers/MonthlyLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/MonthlyRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/MonthlyReset"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"405":{"$ref":"#/components/responses/E405"},"409":{"$ref":"#/components/responses/E409"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"503":{"$ref":"#/components/responses/E503"}},"x-example-request":"/v2/vehicles/0005-DDL/wheels/WH43"}},"/v2/engine-codes":{"get":{"tags":["Vehicle search"],"summary":"Engine codes with power range and number of vehicles","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":100},"description":"Engine code contains this text."},{"name":"brand","in":"query","required":false,"schema":{"type":"string","maxLength":100},"description":"Brand contains this text."},{"name":"fuel","in":"query","required":false,"schema":{"type":"string"},"description":"Comma-separated codes of the code list fuel."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100},"description":"Page size (default 50)."},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"},"description":"Opaque cursor from meta.next_cursor."},{"name":"data_version","in":"query","required":false,"schema":{"type":"string"},"description":"Optional: fail with 409 if the active data release differs."},{"name":"If-None-Match","in":"header","required":false,"schema":{"type":"string"},"description":"ETag for the same request; unchanged: 304 without a body."}],"responses":{"200":{"description":"Engine codes in code order.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/EngineCode"}},"meta":{"$ref":"#/components/schemas/MetaSearch"},"attribution":{"$ref":"#/components/schemas/Attribution"}}},"example":{"data":[{"engine_code":"B47","display_code":"B47","displacement_ccm":1995,"power_kw_min":85,"power_kw_max":170,"vehicle_count":231,"application_count":342}],"meta":{"api_version":2,"data_version":"2026-11-20.ea6570d403d7","total":6,"next_cursor":"eyJ2IjoiMjAyNi0xMS0yMC5lYTY1NzBkNDAzZDciLCJrIjoiZW5naW5lX2NvZGVzIiwiaWQiOiJlbmdpbmVfY29kZXN8L3YyL2VuZ2luZS1jb2Rlc3xxPUI0NyIsInAiOjF9"},"attribution":[{"source":"kba","publisher":"Kraftfahrt-Bundesamt (KBA)","license":{"name":"Datenlizenz Deutschland – Namensnennung – Version 2.0","id":"dl-de/by-2-0","url":"https://www.govdata.de/dl-de/by-2-0"},"datasets":[{"name":"FZ 6 – Bestand an Kraftfahrzeugen und Kraftfahrzeuganhängern nach Herstellern und Typen, Stand 01.01.2026","url":"https://data.gov.de/suche/daten/fz-6-2026-bestand-an-kraftfahrzeugen-und-kraftfahrzeuganhangern-nach-hersteller-und-typen-am-1-?ids=6ae58c67-8615-4417-85e3-fd05fbfae605"},{"name":"FZ Hersteller Handelsnamen Pkw","url":"https://data.gov.de/suche/daten/fz-hersteller-handelsnamen-pkw"},{"name":"KBA-Verzeichnis SV 4.2, Stand 15.08.2026","url":"https://www.kba.de/SharedDocs/Downloads/DE/SV/sv42_pdf.pdf"}],"note":"Daten verändert: eigene Berechnungen auf Grundlage von Daten des Kraftfahrt-Bundesamtes"}]}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"X-RateLimit-Limit":{"$ref":"#/components/headers/MonthlyLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/MonthlyRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/MonthlyReset"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"}}},"304":{"description":"Unchanged response; use the previously cached body. No response body. Authenticated requests still count towards usage.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"X-RateLimit-Limit":{"$ref":"#/components/headers/MonthlyLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/MonthlyRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/MonthlyReset"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"403":{"$ref":"#/components/responses/E403"},"405":{"$ref":"#/components/responses/E405"},"409":{"$ref":"#/components/responses/E409"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"503":{"$ref":"#/components/responses/E503"}},"x-example-request":"/v2/engine-codes?q=B47&limit=1"}},"/v2/engine-codes/{engine_code}/vehicles":{"get":{"tags":["Vehicle search"],"summary":"Vehicle variants with this engine code","parameters":[{"name":"engine_code","in":"path","required":true,"schema":{"type":"string"},"description":"Engine code from /v2/engine-codes."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100},"description":"Page size (default 50)."},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"},"description":"Opaque cursor from meta.next_cursor."},{"name":"data_version","in":"query","required":false,"schema":{"type":"string"},"description":"Optional: fail with 409 if the active data release differs."},{"name":"If-None-Match","in":"header","required":false,"schema":{"type":"string"},"description":"ETag for the same request; unchanged: 304 without a body."}],"responses":{"200":{"description":"Vehicle variants ordered by brand, model and production start.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/VehicleVariant"}},"meta":{"$ref":"#/components/schemas/MetaSearch"},"attribution":{"$ref":"#/components/schemas/Attribution"}}},"example":{"data":[{"vehicle_id":"0005-BYW","selection_id":"var_f23-2015-140kw-diesel-identity-17d3e92a64add9d0","brand":"BMW","model":"Cabrio - 1C (F23)","label":"Cabrio - 1C (F23)","body_type_code":"convertible","body_type_label":"Cabrio","fuel_code":"diesel","fuel_label":"Diesel","drivetrain_code":"rear","drivetrain_label":"Heckantrieb","year_from":"2015","year_to":"2017","years_label":"2015 – 2017","body":{"doors":2,"seats":4},"dimensions":{"length_mm":4430,"width_mm":1770,"height_mm":1410},"powertrain":{"power_kw":140,"power_ps":190,"displacement_ccm":1995},"weights":{"curb_kg":1630,"gross_kg":2025},"towing":{"braked_kg":1500,"unbraked_kg":750,"nose_weight_kg":75},"engine":{"type":"Dieselmotor","codes":["B47"],"codes_normalized":["B47"]},"completeness":28}],"meta":{"api_version":2,"data_version":"2026-11-20.ea6570d403d7","engine_code":"B47","total":342,"next_cursor":"eyJ2IjoiMjAyNi0xMS0yMC5lYTY1NzBkNDAzZDciLCJrIjoiZW5naW5lX3ZlaGljbGVzIiwiaWQiOiJlbmdpbmVfdmVoaWNsZXN8L3YyL2VuZ2luZS1jb2Rlcy9CNDcvdmVoaWNsZXN8IiwicCI6MX0"},"attribution":[{"source":"kba","publisher":"Kraftfahrt-Bundesamt (KBA)","license":{"name":"Datenlizenz Deutschland – Namensnennung – Version 2.0","id":"dl-de/by-2-0","url":"https://www.govdata.de/dl-de/by-2-0"},"datasets":[{"name":"FZ 6 – Bestand an Kraftfahrzeugen und Kraftfahrzeuganhängern nach Herstellern und Typen, Stand 01.01.2026","url":"https://data.gov.de/suche/daten/fz-6-2026-bestand-an-kraftfahrzeugen-und-kraftfahrzeuganhangern-nach-hersteller-und-typen-am-1-?ids=6ae58c67-8615-4417-85e3-fd05fbfae605"},{"name":"FZ Hersteller Handelsnamen Pkw","url":"https://data.gov.de/suche/daten/fz-hersteller-handelsnamen-pkw"},{"name":"KBA-Verzeichnis SV 4.2, Stand 15.08.2026","url":"https://www.kba.de/SharedDocs/Downloads/DE/SV/sv42_pdf.pdf"}],"note":"Daten verändert: eigene Berechnungen auf Grundlage von Daten des Kraftfahrt-Bundesamtes"}]}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"X-RateLimit-Limit":{"$ref":"#/components/headers/MonthlyLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/MonthlyRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/MonthlyReset"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"}}},"304":{"description":"Unchanged response; use the previously cached body. No response body. Authenticated requests still count towards usage.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"X-RateLimit-Limit":{"$ref":"#/components/headers/MonthlyLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/MonthlyRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/MonthlyReset"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"403":{"description":"Key inactive (subscription_inactive)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"$ref":"#/components/responses/E405"},"409":{"$ref":"#/components/responses/E409"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"503":{"$ref":"#/components/responses/E503"}},"x-example-request":"/v2/engine-codes/B47/vehicles?limit=1","description":"Call it from your server with your key and secret."}},"/v2/wheels":{"get":{"tags":["Wheel catalog"],"summary":"Wheel catalog","description":"Wheel images (preview, showcase, colors including views_transparent and complete_wheel) belong to the wheel image module; an API key without it gets the same response as for a wheel without images (color_count 0), all other fields unchanged.","parameters":[{"name":"brand","in":"query","required":false,"schema":{"type":"string"},"description":"Wheel brand, case-insensitive. Other names of the same brand match too (MM-Concepts = MM-Wheels)."},{"name":"q","in":"query","required":false,"schema":{"type":"string","minLength":2,"maxLength":50},"description":"Search code, model or brand."},{"name":"diameter_inch","in":"query","required":false,"schema":{"type":"number"},"description":"Available diameter."},{"name":"include","in":"query","required":false,"schema":{"type":"string","enum":["colors"]},"description":"colors: colors with all image views per wheel in the list (saves one detail request per wheel)."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100},"description":"Page size (default 50)."},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"},"description":"Opaque cursor from meta.next_cursor."},{"name":"data_version","in":"query","required":false,"schema":{"type":"string"},"description":"Optional: fail with 409 if the active data release differs."},{"name":"If-None-Match","in":"header","required":false,"schema":{"type":"string"},"description":"ETag for the same request; unchanged: 304 without a body."}],"responses":{"200":{"description":"Catalog wheels.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/CatalogWheelListItem"}},"meta":{"$ref":"#/components/schemas/MetaSearch"}}},"example":{"data":[{"wheel_code":"WH43","brand":"Wheelworld","model_name":"WH43","diameters_inch":[18,19,20],"vehicle_count":8507,"variant_count":15,"color_count":0,"document_count":57,"updated_at":"2026-10-28 18:26:48"}],"meta":{"api_version":2,"data_version":"2026-11-20.ea6570d403d7","total":1,"next_cursor":null}}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"X-RateLimit-Limit":{"$ref":"#/components/headers/MonthlyLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/MonthlyRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/MonthlyReset"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"}}},"304":{"description":"Unchanged response; use the previously cached body. No response body. Authenticated requests still count towards usage.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"X-RateLimit-Limit":{"$ref":"#/components/headers/MonthlyLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/MonthlyRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/MonthlyReset"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"403":{"$ref":"#/components/responses/E403"},"405":{"$ref":"#/components/responses/E405"},"409":{"$ref":"#/components/responses/E409"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"503":{"$ref":"#/components/responses/E503"}},"x-example-request":"/v2/wheels?q=WH43&limit=1"}},"/v2/wheels/{wheel_code}":{"get":{"tags":["Wheel catalog"],"summary":"Catalog wheel with colors, images, variants and documents","description":"Wheel images (preview, showcase, colors including views_transparent and complete_wheel) belong to the wheel image module; an API key without it gets the same response as for a wheel without images (color_count 0), all other fields unchanged.","parameters":[{"name":"wheel_code","in":"path","required":true,"schema":{"type":"string"},"description":"Wheel code."},{"name":"If-None-Match","in":"header","required":false,"schema":{"type":"string"},"description":"ETag for the same request; unchanged: 304 without a body."}],"responses":{"200":{"description":"Catalog wheel.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/CatalogWheelDetail"},"meta":{"$ref":"#/components/schemas/Meta"},"attribution":{"$ref":"#/components/schemas/Attribution"}}},"example":{"data":{"wheel_code":"WH43","brand":"Wheelworld","model_name":"WH43","diameters_inch":[18,19,20],"vehicle_count":8507,"variant_count":15,"color_count":0,"document_count":57,"updated_at":"2026-10-28 18:26:48","colors":[],"variants":[{"size":"8,5x19","width_inch":8.5,"diameter_inch":19,"et_mm":30,"pcd":"5x112","center_bore_mm":66.6},{"size":"8,5x19","width_inch":8.5,"diameter_inch":19,"et_mm":40,"pcd":"5x112","center_bore_mm":66.6}],"documents":[{"document_id":"doc_e811c45191e2b80cceb3ce8e","approval_type":"KBA","approval_number":"55675*03"}]},"meta":{"api_version":2,"data_version":"2026-11-20.ea6570d403d7"}}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"X-RateLimit-Limit":{"$ref":"#/components/headers/MonthlyLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/MonthlyRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/MonthlyReset"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"}}},"304":{"description":"Unchanged response; use the previously cached body. No response body. Authenticated requests still count towards usage.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"X-RateLimit-Limit":{"$ref":"#/components/headers/MonthlyLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/MonthlyRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/MonthlyReset"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"405":{"$ref":"#/components/responses/E405"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"503":{"$ref":"#/components/responses/E503"}},"x-example-request":"/v2/wheels/WH43"}},"/v2/vehicles/{vehicle_id}/images":{"get":{"tags":["Configurator images"],"summary":"Configurator image sets for a vehicle (add-on module)","description":"Image groups of the vehicle with all wheels whose image set is published and that are approved for exactly this vehicle. Needs the configurator image module on the API key (403 feature_not_enabled otherwise). body_match tells whether the image shows exactly this body type.","parameters":[{"name":"vehicle_id","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9]{4}-[A-Z0-9]{3}$"},"description":"HSN-TSN, e.g. 0005-DFY."},{"name":"If-None-Match","in":"header","required":false,"schema":{"type":"string"},"description":"ETag for the same request; unchanged: 304 without a body."}],"responses":{"200":{"description":"Availability.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/ImageAvailability"},"meta":{"$ref":"#/components/schemas/Meta"},"attribution":{"$ref":"#/components/schemas/Attribution"}}},"example":{"data":{"available":true,"ambiguous":false,"body_notice":null,"matches":[{"vehicle_image":{"vehicle_image_id":"bmw-3er-g20","label":"BMW 3er (G20)","brand":"BMW","model":"3er","generation":"G20","body_type":"Limousine","years":{"from":2019,"to":2022},"body_match":"exact","body_notice":null},"matched_by":"vehicle_id","fitment_checked":true,"wheels":[{"wheel_code":"FF01","revision":"24cb8a273c5f52a6","release_type":"layered","preferred_delivery":"layers","delivery_modes":["layers","edge_render"],"paints":[{"id":"deep_black","label":"Jet Black","hex":"#0E0E0F"}],"finishes":[{"id":"black","label":"Black"}],"views":["side"],"renditions":[{"key":"large","width":1400}],"wheel_sizes":[18,19],"default_wheel_size":19}]}]},"meta":{"api_version":2,"data_version":"2026-11-20.ea6570d403d7"}}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"X-RateLimit-Limit":{"$ref":"#/components/headers/MonthlyLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/MonthlyRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/MonthlyReset"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"}}},"304":{"description":"Unchanged response; use the previously cached body. No response body. Authenticated requests still count towards usage.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"X-RateLimit-Limit":{"$ref":"#/components/headers/MonthlyLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/MonthlyRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/MonthlyReset"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"403":{"$ref":"#/components/responses/E403"},"405":{"$ref":"#/components/responses/E405"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"503":{"$ref":"#/components/responses/E503"}},"x-example-request":"/v2/vehicles/0005-DDL/images"}},"/v2/vehicles/{vehicle_id}/images/{wheel_code}":{"get":{"tags":["Configurator images"],"summary":"Configurator images of one wheel, paint and finish on a vehicle (add-on module)","description":"delivery=render (default): one finished image per view and size, rendered at the edge. delivery=layers: base and overlay layers with placement for client-side composition in render_order (base = the vehicle in the selected paint, then paint_patch where the wheel changes the paint, then wheel). Sizes are limited to the wheel sizes approved for this vehicle (404 wheel_size_not_approved_for_vehicle with the approved wheel_sizes). wheel_code=original: the vehicle with its original wheels in the selected paint (finish and size not needed, no fitment check, also the small renditions from original_wheels). wheel_code=original is also available with the vehicle image module alone (without the configurator module); then the response is always the finished images (delivery full_images, no layers). Links are signed, valid at least one hour and identical within the hour (expires_at; meta.urls_expire_at is the earliest).","parameters":[{"name":"vehicle_id","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9]{4}-[A-Z0-9]{3}$"},"description":"HSN-TSN, e.g. 0005-DFY."},{"name":"wheel_code","in":"path","required":true,"schema":{"type":"string"},"description":"Wheel code from the availability, or original for the original wheels."},{"name":"paint","in":"query","required":false,"schema":{"type":"string"},"description":"Paint id from the availability (required)."},{"name":"finish","in":"query","required":false,"schema":{"type":"string"},"description":"Finish id from the availability (required except for wheel_code=original; older finish ids from finish_aliases are accepted)."},{"name":"size","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":30},"description":"Wheel size in inches (default: default_wheel_size)."},{"name":"delivery","in":"query","required":false,"schema":{"type":"string","enum":["render","layers"]},"description":"render (default) or layers."},{"name":"vehicle_image_id","in":"query","required":false,"schema":{"type":"string"},"description":"Image group, needed when the vehicle belongs to several groups (400 configurator_vehicle_ambiguous)."},{"name":"If-None-Match","in":"header","required":false,"schema":{"type":"string"},"description":"ETag for the same request; unchanged: 304 without a body."}],"responses":{"200":{"description":"Images.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/ConfiguratorImages"},"meta":{"$ref":"#/components/schemas/MetaImages"}}},"example":{"data":{"vehicle_image":{"vehicle_image_id":"bmw-3er-g20","label":"BMW 3er (G20)","brand":"BMW","model":"3er","generation":"G20","body_type":"Limousine","years":{"from":2019,"to":2022},"body_match":"exact","body_notice":null},"matched_by":"vehicle_id","fitment_checked":true,"delivery":"edge_render","selection":{"wheel_code":"FF01","paint":"deep_black","finish":"black","size":19},"revision":"24cb8a273c5f52a6","views":{"side":{"large":{"url":"https://images.example/v3/render/bmw-3er-g20/FF01/24cb8a273c5f52a6/black/deep_black/19/side/large.webp?exp=1792807200&tenant=1&sig=…","expires_at":"2026-10-24T02:00:00.000Z","format":"webp","mime_type":"image/webp","width":1400,"height":780,"dynamic":true}}}},"meta":{"api_version":2,"data_version":"2026-11-20.ea6570d403d7","urls_expire_at":"2026-10-24T02:00:00.000Z"}}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"X-RateLimit-Limit":{"$ref":"#/components/headers/MonthlyLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/MonthlyRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/MonthlyReset"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"}}},"304":{"description":"Unchanged response; use the previously cached body. No response body. Authenticated requests still count towards usage.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"X-RateLimit-Limit":{"$ref":"#/components/headers/MonthlyLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/MonthlyRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/MonthlyReset"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"405":{"$ref":"#/components/responses/E405"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"503":{"$ref":"#/components/responses/E503"}},"x-example-request":"/v2/vehicles/0005-DDL/images/FF01?paint=deep_black&finish=black&size=19"}},"/v2/vehicle-images/{vehicle_image_id}":{"get":{"tags":["Configurator images"],"summary":"One configurator image group with its published wheels (add-on module)","description":"Like /v2/vehicles/{vehicle_id}/images for one image group, without the per-vehicle wheel approval check (fitment_checked false).","parameters":[{"name":"vehicle_image_id","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9_-]{1,80}$"},"description":"Image group id."},{"name":"If-None-Match","in":"header","required":false,"schema":{"type":"string"},"description":"ETag for the same request; unchanged: 304 without a body."}],"responses":{"200":{"description":"Availability.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/ImageAvailability"},"meta":{"$ref":"#/components/schemas/Meta"},"attribution":{"$ref":"#/components/schemas/Attribution"}}},"example":{"data":{"available":true,"ambiguous":false,"body_notice":null,"matches":[{"matched_by":"vehicle_image_id","fitment_checked":false,"wheels":[{"wheel_code":"FF01","revision":"24cb8a273c5f52a6","release_type":"layered","preferred_delivery":"layers","delivery_modes":["layers","edge_render"],"paints":[{"id":"deep_black","label":"Jet Black","hex":"#0E0E0F"}],"finishes":[{"id":"black","label":"Black"}],"views":["side"],"renditions":[{"key":"large","width":1400}],"wheel_sizes":[18,19],"default_wheel_size":19}],"vehicle_image":{"vehicle_image_id":"bmw-3er-g20","label":"BMW 3er (G20)","brand":"BMW","model":"3er","generation":"G20","body_type":"Limousine","years":{"from":2019,"to":2022}}}]},"meta":{"api_version":2,"data_version":"2026-11-20.ea6570d403d7"}}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"X-RateLimit-Limit":{"$ref":"#/components/headers/MonthlyLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/MonthlyRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/MonthlyReset"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"}}},"304":{"description":"Unchanged response; use the previously cached body. No response body. Authenticated requests still count towards usage.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"X-RateLimit-Limit":{"$ref":"#/components/headers/MonthlyLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/MonthlyRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/MonthlyReset"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"403":{"$ref":"#/components/responses/E403"},"405":{"$ref":"#/components/responses/E405"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"503":{"$ref":"#/components/responses/E503"}},"x-example-request":"/v2/vehicle-images/bmw-3er-g20"}},"/v2/vehicle-images/{vehicle_image_id}/{wheel_code}":{"get":{"tags":["Configurator images"],"summary":"Configurator images of one wheel, paint and finish in an image group (add-on module)","parameters":[{"name":"vehicle_image_id","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9_-]{1,80}$"},"description":"Image group id."},{"name":"wheel_code","in":"path","required":true,"schema":{"type":"string"},"description":"Wheel code, or original for the original wheels."},{"name":"paint","in":"query","required":false,"schema":{"type":"string"},"description":"Paint id (required)."},{"name":"finish","in":"query","required":false,"schema":{"type":"string"},"description":"Finish id (required except for wheel_code=original)."},{"name":"size","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":30},"description":"Wheel size in inches (default: default_wheel_size)."},{"name":"delivery","in":"query","required":false,"schema":{"type":"string","enum":["render","layers"]},"description":"render (default) or layers."},{"name":"If-None-Match","in":"header","required":false,"schema":{"type":"string"},"description":"ETag for the same request; unchanged: 304 without a body."}],"responses":{"200":{"description":"Images.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/ConfiguratorImages"},"meta":{"$ref":"#/components/schemas/MetaImages"}}},"example":{"data":{"vehicle_image":{"vehicle_image_id":"bmw-3er-g20","label":"BMW 3er (G20)","brand":"BMW","model":"3er","generation":"G20","body_type":"Limousine","years":{"from":2019,"to":2022},"body_match":"exact","body_notice":null},"matched_by":"vehicle_image_id","fitment_checked":false,"delivery":"edge_render","selection":{"wheel_code":"FF01","paint":"deep_black","finish":"black","size":19},"revision":"24cb8a273c5f52a6","views":{"side":{"large":{"url":"https://images.example/v3/render/bmw-3er-g20/FF01/24cb8a273c5f52a6/black/deep_black/19/side/large.webp?exp=1792807200&tenant=1&sig=…","expires_at":"2026-10-24T02:00:00.000Z","format":"webp","mime_type":"image/webp","width":1400,"height":780,"dynamic":true}}}},"meta":{"api_version":2,"data_version":"2026-11-20.ea6570d403d7","urls_expire_at":"2026-10-24T02:00:00.000Z"}}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"X-RateLimit-Limit":{"$ref":"#/components/headers/MonthlyLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/MonthlyRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/MonthlyReset"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"}}},"304":{"description":"Unchanged response; use the previously cached body. No response body. Authenticated requests still count towards usage.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"X-RateLimit-Limit":{"$ref":"#/components/headers/MonthlyLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/MonthlyRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/MonthlyReset"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"405":{"$ref":"#/components/responses/E405"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"503":{"$ref":"#/components/responses/E503"}},"x-example-request":"/v2/vehicle-images/bmw-3er-g20/FF01?paint=deep_black&finish=black&size=19"}},"/v2/documents":{"get":{"tags":["Documents"],"summary":"Approval documents (Gutachten) per wheel code: geometries, obligation codes, fasteners and link","parameters":[{"name":"wheel_code","in":"query","required":false,"schema":{"type":"string"},"description":"Comma-separated wheel codes, up to 50."},{"name":"brand","in":"query","required":false,"schema":{"type":"string","minLength":1},"description":"Wheel brand as in the wheel catalog (/v2/wheels), case-insensitive. Other names of the same brand match too (MM-Concepts = MM-Wheels)."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100},"description":"Page size (default 50)."},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"},"description":"Opaque cursor from meta.next_cursor."},{"name":"data_version","in":"query","required":false,"schema":{"type":"string"},"description":"Optional: fail with 409 if the active data release differs."},{"name":"If-None-Match","in":"header","required":false,"schema":{"type":"string"},"description":"ETag for the same request; unchanged: 304 without a body."}],"responses":{"200":{"description":"Documents per wheel code, ordered by wheel code and document.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/DocumentListItem"}},"meta":{"$ref":"#/components/schemas/MetaPaged"}}},"example":{"data":[{"document_id":"doc_e811c45191e2b80cceb3ce8e","wheel_code":"WH43","approval_type":"KBA","approval_number":"55675*03","kba_number":"55675","entries":[{"pcd":"5x112","center_bore_mm":66.6,"et_mm":30,"width_inch":8.5,"diameter_inch":20},{"pcd":"5x112","center_bore_mm":66.6,"et_mm":30,"width_inch":9,"diameter_inch":20}],"obligation_codes":["A01","A10","A12","A14"],"fasteners":[{"code":"S01","type":"schraube","thread":"M14x1,5","seat":"Kugel","seat_diameter_mm":28,"torque_nm":130,"shaft_length_mm":30,"shaft_length_status":"documented","row_status":"complete"},{"code":"S02","type":"schraube","thread":"M14x1,5","seat":"Kugel","seat_diameter_mm":28,"torque_nm":150,"shaft_length_mm":30,"shaft_length_status":"documented","row_status":"complete"}],"fastener_status":"parsed_complete","url":"https://cdn.api4cars.com/WH43/hersteller/WH43_09378e47d9d419cd22e12ef145e67b879b8b12b8c56e7eaff6ce2dad5407a0fa.pdf"}],"meta":{"api_version":2,"data_version":"2026-11-20.ea6570d403d7","next_cursor":"eyJ2IjoiMjAyNi0xMS0yMC5lYTY1NzBkNDAzZDciLCJrIjoiZG9jdW1lbnRzIiwiaWQiOiJsaXN0IiwicCI6MTAzMzN9"}}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"X-RateLimit-Limit":{"$ref":"#/components/headers/MonthlyLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/MonthlyRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/MonthlyReset"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"}}},"304":{"description":"Unchanged response; use the previously cached body. No response body. Authenticated requests still count towards usage.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"X-RateLimit-Limit":{"$ref":"#/components/headers/MonthlyLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/MonthlyRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/MonthlyReset"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"403":{"description":"Key inactive (subscription_inactive)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"$ref":"#/components/responses/E405"},"409":{"$ref":"#/components/responses/E409"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"503":{"$ref":"#/components/responses/E503"}},"x-example-request":"/v2/documents?wheel_code=WH43&limit=1","description":"Call it from your server with your key and secret."}},"/v2/documents/{document_id}":{"get":{"tags":["Documents"],"summary":"Approval document (Gutachten) with obligation texts and link","parameters":[{"name":"document_id","in":"path","required":true,"schema":{"type":"string","pattern":"^doc_[a-f0-9]{24}$"},"description":"Document id."},{"name":"If-None-Match","in":"header","required":false,"schema":{"type":"string"},"description":"ETag for the same request; unchanged: 304 without a body."}],"responses":{"200":{"description":"Document.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Document"},"meta":{"$ref":"#/components/schemas/Meta"},"attribution":{"$ref":"#/components/schemas/Attribution"}}},"example":{"data":{"document_id":"doc_e811c45191e2b80cceb3ce8e","approval_type":"KBA","approval_number":"55675*03","kba_number":"55675","obligations":{"A01":"Nach Durchführung der Technischen Änderung ist das Fahrzeug unter Vorlage der vorliegenden ABE unverzüglich einem amtlich anerkannten Sachverständigen oder Prüfer für den Kraftfahrzeugverkehr oder einem Prüfingenieur einer Überwachungsorganisation nach Nummer 4 der Anlage VIIIb zur StVZO zur Durchführung und Bestätigung der in der ABE vorgeschriebenen Änderungsabnahme vorzuführen.","A10":"Es dürfen nur feingliedrige bzw. die lt. Betriebsanleitung/Handbuch vorgeschriebenen Schneeketten an der Hinterachse verwendet werden.","A12":"Die Verwendung von Schneeketten ist nicht zulässig.","A14":"Zum Auswuchten der Räder dürfen an der Felgenaußenseite nur Klebegewichte unterhalb der Felgenschulter oder des Tiefbettes angebracht werden. Bei Anbringung der Klebegewichte im Felgenbett ist auf einen Mindestabstand von 2 mm zum Bremssattel zu achten."},"url":"https://cdn.api4cars.com/WH43/hersteller/WH43_09378e47d9d419cd22e12ef145e67b879b8b12b8c56e7eaff6ce2dad5407a0fa.pdf"},"meta":{"api_version":2,"data_version":"2026-11-20.ea6570d403d7"}}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"X-RateLimit-Limit":{"$ref":"#/components/headers/MonthlyLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/MonthlyRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/MonthlyReset"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"}}},"304":{"description":"Unchanged response; use the previously cached body. No response body. Authenticated requests still count towards usage.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"X-RateLimit-Limit":{"$ref":"#/components/headers/MonthlyLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/MonthlyRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/MonthlyReset"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"405":{"$ref":"#/components/responses/E405"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"503":{"$ref":"#/components/responses/E503"}},"x-example-request":"/v2/documents/doc_e811c45191e2b80cceb3ce8e"}}},"components":{"securitySchemes":{"ApiKey":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Your API key (ck_v2_…), always together with X-API-Secret. Call the API from your own server; the secret never belongs in browser code."},"ApiSecret":{"type":"apiKey","in":"header","name":"X-API-Secret"},"Bearer":{"type":"http","scheme":"bearer","description":"Bearer <key>:<secret>"}},"headers":{"ETag":{"description":"Response validator. Except for /v2/me and /v2/me/usage, send it as If-None-Match on the same request to receive 304 without a body when unchanged. Always request fresh usage data on those two routes; do not reuse a cached body.","schema":{"type":"string"}},"MonthlyLimit":{"description":"Monthly quota that applies to the key, same value as monthly_limit in /v2/me (see quota_scope there). Only on authenticated responses with a finite quota. This is not the short-term request limit.","schema":{"type":"integer","minimum":0}},"MonthlyRemaining":{"description":"Requests left in that monthly quota, same value as remaining in /v2/me. Only together with X-RateLimit-Limit; this is not the short-term request limit.","schema":{"type":"integer","minimum":0}},"MonthlyReset":{"description":"When that quota starts again, as Unix time in seconds, same moment as reset_at in /v2/me. Only together with X-RateLimit-Limit and when the moment is known.","schema":{"type":"integer","minimum":0}},"ServerTiming":{"description":"Diagnostics: db;dur=<ms>;desc=\"<queries>q <rows read>r\" and edge;desc=hit|miss|304|off (response cache at the edge). Informational only; the format may be extended.","schema":{"type":"string"}},"RetryAfter":{"description":"Seconds until retry after 429. quota_exceeded means monthly quota exhausted without permitted overage; with permitted overage, otherwise valid requests continue with 200. too_many_requests means the separate short-term brake.","schema":{"type":"integer","minimum":0}}},"responses":{"E400":{"description":"Invalid request (unknown_parameter, duplicate_parameter, invalid_path, invalid_parameter, invalid_query, too_many_filters, too_many_wheel_codes, invalid_limit, invalid_cursor, invalid_include, invalid_view, invalid_sort, invalid_status, invalid_vehicle_id, invalid_wheel_code, invalid_document_id, invalid_generation_id, invalid_brand_id, invalid_model_id, invalid_engine_code, invalid_execution, invalid_brand, invalid_model, invalid_pcd, invalid_et, invalid_diameter, invalid_fuel, invalid_with_fitments, invalid_with_logo, invalid_date, invalid_date_range, invalid_axle, invalid_product_code, invalid_vsn, invalid_selection, invalid_size, invalid_delivery, invalid_vehicle_image_id, invalid_ids, invalid_selections, missing_filter, missing_brand, missing_selection, selection_not_for_vehicle, selection_not_supported, variant_not_for_vehicle, configuration_not_for_vehicle, configurator_vehicle_ambiguous, configurator_layers_unavailable); invalid_<parameter> names the filter (e.g. invalid_doors).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"E401":{"description":"Missing or invalid credentials (unauthorized, invalid_credentials).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"E403":{"description":"Key inactive or add-on module not enabled (subscription_inactive, feature_not_enabled).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"E404":{"description":"Not found (route_not_found, vehicle_not_found, wheel_not_found, document_not_found, brand_not_found, model_not_found, generation_not_found, configurator_not_found, configurator_selection_not_found, configurator_size_not_found, configurator_body_image_missing, configurator_wheel_not_published, wheel_not_approved_for_vehicle, wheel_size_not_approved_for_vehicle).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"E405":{"description":"Method not allowed (only GET and OPTIONS) (method_not_allowed).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"E409":{"description":"The data release changed since the cursor or data_version was issued; restart from the first page (data_version_changed).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"E429":{"description":"Monthly quota used up without permitted overage (quota_exceeded), or too many requests in a short time (too_many_requests); see Retry-After. With permitted overage, otherwise valid requests continue with 200 (quota_exceeded, too_many_requests).","headers":{"Retry-After":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"E500":{"description":"Unexpected error (internal_error).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"E503":{"description":"Temporarily unavailable; see Retry-After where sent (data_unavailable, not_in_release, service_unavailable, usage_unavailable, configurator_edge_not_configured, configurator_asset_invalid).","headers":{"Retry-After":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"schemas":{"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","status"],"properties":{"code":{"type":"string","description":"Stable machine-readable error code (see the error reference). Decide on this code, not on message."},"message":{"type":"string","description":"Human-readable explanation in English. The wording may change."},"status":{"type":"integer","description":"HTTP status of the response, repeated in the body."},"details":{"type":"object","description":"Optional details, e.g. the rejected value or the allowed values."}},"description":"The error. HTTP status, code and message are always present."}},"example":{"error":{"code":"vehicle_not_found","message":"Vehicle not found.","status":404,"details":{"vehicle_id":"9999-ZZZ"}}}},"Meta":{"type":"object","required":["api_version","data_version"],"properties":{"api_version":{"type":"integer","const":2,"description":"Major version of the API (always 2)."},"data_version":{"type":"string","description":"Active data release that produced this response."}}},"MetaPaged":{"type":"object","required":["api_version","data_version","next_cursor"],"properties":{"api_version":{"type":"integer","description":"Major version of the API (always 2)."},"data_version":{"type":"string","description":"Active data release that produced this response."},"next_cursor":{"type":["string","null"],"description":"Cursor of the next page; null on the last page."}}},"MetaWheels":{"type":"object","required":["api_version","data_version","selection"],"properties":{"api_version":{"type":"integer"},"data_version":{"type":"string"},"vsn_selection":{"type":"object","required":["status"],"description":"Only with the vsn parameter.","properties":{"vsn":{"type":["string","null"]},"status":{"type":"string","enum":["matched","matched_not_applied","ambiguous","unknown","not_determinable","absent"],"description":"matched: the variant was preselected; matched_not_applied: a selection was sent and takes precedence; ambiguous: several variants carry the VSN; unknown: no variant carries it; not_determinable: VSN 00000."},"selection_id":{"type":"string","description":"The variant that carries the VSN (matched, matched_not_applied)."},"hint":{"type":"string"}}},"next_cursor":{"type":["string","null"]},"total":{"type":"integer","minimum":0,"description":"Wheel offer list only: number of offers matching the request over all pages."},"wheels_available":{"type":"boolean","description":"Wheel endpoints only (always there): false when no wheel statement is available for the vehicle or selection; data is then empty and unavailable_reason says why."},"unavailable_reason":{"type":"string","enum":["fitment_evidence_required","configuration_evidence_required","variant_facts_unavailable"],"description":"Only when no statement is available: fitment_evidence_required (no verified wheel data for the vehicle), configuration_evidence_required (the selection needs verified data of an EU configuration), variant_facts_unavailable (no verified facts for this variant). An empty list with this reason means \"no statement\", never \"nothing fits\"."},"selection":{"type":"object","required":["status"],"properties":{"id":{"type":["string","null"]},"type":{"type":["string","null"]},"status":{"type":"string","enum":["none","applied","superseded","ambiguous"],"description":"none: no selection sent; applied: the selection narrowed the result; superseded: an old variant key was replaced by its successor (applied_id); ambiguous: the selection names several variants, the result is the one without selection (candidates in applied_ids)."},"applied_id":{"type":"string","description":"Superseded keys only: the successor that was applied."},"applied_ids":{"type":"array","items":{"type":"string"},"description":"The variants or configurations that were actually applied (status applied or superseded), or the candidate variants (status ambiguous). Absent when no selection was sent."}}}}},"MetaCompare":{"type":"object","required":["api_version","data_version","comparison_basis"],"properties":{"api_version":{"type":"integer"},"data_version":{"type":"string"},"comparison_basis":{"type":"string","const":"documented_vehicle_variants"},"selections":{"type":"array","description":"Only with the selections parameter: per vehicle as meta.selection of the wheel endpoints.","items":{"type":"object","required":["vehicle_id","status"],"properties":{"vehicle_id":{"type":"string"},"id":{"type":["string","null"]},"type":{"type":["string","null"]},"status":{"type":"string","enum":["applied","superseded","ambiguous"]},"applied_id":{"type":"string"},"applied_ids":{"type":"array","items":{"type":"string"}}}}}}},"MetaVehicle":{"type":"object","required":["api_version","data_version"],"properties":{"api_version":{"type":"integer"},"data_version":{"type":"string"},"selection":{"type":"object","description":"Only with the selection parameter (or a matched vsn): as meta.selection of the wheel endpoints."},"vsn_selection":{"type":"object","required":["status"],"description":"Only with the vsn parameter.","properties":{"vsn":{"type":["string","null"]},"status":{"type":"string","enum":["matched","matched_not_applied","ambiguous","unknown","not_determinable","absent"],"description":"matched: the variant was preselected; matched_not_applied: a selection was sent and takes precedence; ambiguous: several variants carry the VSN; unknown: no variant carries it; not_determinable: VSN 00000."},"selection_id":{"type":"string","description":"The variant that carries the VSN (matched, matched_not_applied)."},"hint":{"type":"string"}}}}},"Attribution":{"type":"array","items":{"type":"object"},"description":"Present when the response uses KBA data (dl-de/by-2-0)."},"Status":{"type":"object","required":["status","data_version","checks"],"properties":{"status":{"type":"string","const":"ok"},"data_version":{"type":"string"},"checks":{"type":"object","required":["worker","accounts_db","data_db"],"description":"Live check (ok is reused for up to 10 s). Store down: 503 service_unavailable, see error.details.checks.","properties":{"worker":{"type":"string","const":"ok"},"accounts_db":{"type":"string","const":"ok"},"data_db":{"type":"string","const":"ok"}}}}},"Me":{"type":"object","required":["api_key","month","quota_scope","monthly_limit","remaining","reset_at","overage_allowed","requests_this_month","quota_reported_at","quota_warning"],"description":"One set of quota fields. monthly_limit, remaining and reset_at describe the quota that applies to this key (quota_scope) and are the values of the headers X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset. This request is already counted.","properties":{"api_key":{"type":"string"},"label":{"type":["string","null"]},"month":{"type":"string","pattern":"^[0-9]{4}-[0-9]{2}$","description":"Calendar month (UTC), YYYY-MM."},"quota_scope":{"type":"string","enum":["account","key"],"description":"account: the quota of your account, shared by all its keys; key: the own monthly quota of this key."},"monthly_limit":{"type":["integer","null"],"description":"The quota that applies. account: the allowance at the last account report (quota_reported_at); key: the monthly limit of this key. null = no limit."},"remaining":{"type":["integer","null"],"description":"Requests left in that quota. null = no limit."},"reset_at":{"type":["string","null"],"format":"date-time","description":"When the quota starts again (UTC). key: start of the next calendar month; account: end of the billing period, when known. null = no limit or not known."},"overage_allowed":{"type":"boolean","description":"true: requests beyond the quota continue with 200 and count as overage; false: they get 429 quota_exceeded."},"requests_this_month":{"type":"integer","minimum":0,"description":"Requests of this key in the calendar month (UTC), including this one."},"quota_reported_at":{"type":["string","null"],"format":"date-time","description":"quota_scope account only: time of the last account report; null otherwise."},"quota_warning":{"type":["string","null"],"enum":["quota_report_missing","quota_report_expired","quota_report_stale","shared_quota_unavailable","accounts_unavailable",null],"description":"Set when the account quota could not be read as usual; the key quota or the last known state applies meanwhile. null = all fine."}}},"Usage":{"type":"object","required":["api_key","from","to","requests","endpoints","days"],"properties":{"api_key":{"type":"string"},"from":{"type":"string","format":"date"},"to":{"type":"string","format":"date"},"requests":{"type":"integer","minimum":0},"over_quota":{"type":"integer","minimum":0,"description":"Requests in the period that were rejected with 429 quota_exceeded because the monthly quota was used up (part of requests)."},"endpoints":{"type":"array","items":{"$ref":"#/components/schemas/UsageEndpoint"},"description":"Totals per endpoint over the period."},"days":{"type":"array","items":{"type":"object","required":["day","requests","endpoints"],"properties":{"day":{"type":"string","format":"date"},"requests":{"type":"integer","minimum":0},"over_quota":{"type":"integer","minimum":1},"endpoints":{"type":"array","items":{"$ref":"#/components/schemas/UsageEndpoint"}}}}}}},"UsageEndpoint":{"type":"object","required":["endpoint","requests"],"properties":{"endpoint":{"type":"string","description":"Path template as in this description, e.g. /v2/vehicles/{vehicle_id}/wheels."},"requests":{"type":"integer","minimum":1}}},"Brand":{"type":"object","required":["id","name"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"vehicle_count":{"type":"integer"},"with_fitments_count":{"type":"integer"},"logo_url":{"type":"string"}}},"Model":{"type":"object","required":["id","name"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"with_fitments_count":{"type":"integer"}}},"Execution":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"label":{"type":"string"},"body_type_code":{"type":"string","enum":["sedan","hatchback","fastback","estate","coupe","convertible","suv","van","pickup","panel_van"],"description":"Code list body_type. Missing when unknown."},"body_type_label":{"type":"string","description":"German label of body_type_code (sedan = Limousine, hatchback = Schrägheck, fastback = Fließheck, estate = Kombi, coupe = Coupé, convertible = Cabrio, suv = SUV / Geländewagen, van = Van, pickup = Pick-up, panel_van = Transporter)."},"engine_count":{"type":"integer"}}},"Generation":{"type":"object","required":["id","name"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"year_from":{"type":["string","null"],"pattern":"^[0-9]{4}(-[0-9]{2})?$","description":"Start of production, YYYY-MM when the month is documented, otherwise YYYY. null = unknown."},"year_to":{"type":["string","null"],"pattern":"^[0-9]{4}(-[0-9]{2})?$","description":"End of production in the same form. null = still in production or end unknown."},"years_label":{"type":["string","null"],"description":"Display text derived from year_from and year_to, e.g. \"2020 – 2022\", \"ab 2020\", \"03/2019 – 06/2022\"."},"brand_id":{"type":"string"},"model_id":{"type":"string"},"executions":{"type":"array","items":{"$ref":"#/components/schemas/Execution"}}}},"Engine":{"type":"object","properties":{"name":{"type":"string"},"label":{"type":"string"},"engine_names":{"type":"array","items":{"type":"string"}},"power_kw":{"type":"number"},"power_ps":{"type":"number"},"fuel_code":{"type":"string","enum":["petrol","diesel","electric","hybrid","mild_hybrid","plugin_hybrid","lpg","cng","hydrogen","other"],"description":"Code list fuel. Missing when unknown."},"fuel_label":{"type":"string","description":"German label of fuel_code (petrol = Benzin, diesel = Diesel, electric = Elektro, hybrid = Hybrid, mild_hybrid = Mild-Hybrid, plugin_hybrid = Plug-in-Hybrid, lpg = Autogas (LPG), cng = Erdgas (CNG), hydrogen = Wasserstoff, other = Sonstiger Kraftstoff)."},"drivetrain_code":{"type":"string","enum":["front","rear","all"],"description":"Code list drivetrain. Missing when unknown."},"drivetrain_label":{"type":"string","description":"German label of drivetrain_code (front = Frontantrieb, rear = Heckantrieb, all = Allradantrieb)."},"derived_from_variants":{"type":"array","items":{"type":"string","enum":["fuel","drivetrain"]},"description":"Fields that the catalog did not name for this engine group and that were set because every variant of every vehicle of the group carries the same value (the value shown on the vehicle's selections). Absent when nothing was derived; a field without a unanimous value stays missing."},"transmission_codes":{"type":"array","items":{"type":"string","enum":["manual","automatic","dual_clutch","automated_manual","cvt","single_speed"]}},"transmission_labels":{"type":"array","items":{"type":"string"},"description":"German labels of transmission_codes, same order."},"year_from":{"type":["string","null"],"pattern":"^[0-9]{4}(-[0-9]{2})?$","description":"Start of production, YYYY-MM when the month is documented, otherwise YYYY. null = unknown."},"year_to":{"type":["string","null"],"pattern":"^[0-9]{4}(-[0-9]{2})?$","description":"End of production in the same form. null = still in production or end unknown."},"years_label":{"type":["string","null"],"description":"Display text derived from year_from and year_to, e.g. \"2020 – 2022\", \"ab 2020\", \"03/2019 – 06/2022\"."},"execution":{"$ref":"#/components/schemas/Execution"},"selection_required":{"type":"boolean"},"vehicles":{"type":"array","items":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"selections":{"type":"array","items":{"type":"string"}},"selection_required":{"type":"boolean"}}}}}},"Vehicle":{"type":"object","required":["vehicle_id","hsn","tsn"],"properties":{"vehicle_id":{"type":"string","description":"Vehicle id: HSN and TSN joined by a dash, e.g. 0005-DDL."},"hsn":{"type":"string","description":"Manufacturer key number (4 digits, field 2.1 of the registration certificate)."},"tsn":{"type":"string","description":"Type key number (3 characters, field 2.2 of the registration certificate)."},"brand":{"type":"string","description":"Brand as in the registration data."},"model":{"type":"string","description":"Type designation of the registration data, e.g. \"Limousine - G3L (G20)\"."},"year_from":{"type":["string","null"],"pattern":"^[0-9]{4}(-[0-9]{2})?$","description":"Start of production, YYYY-MM when the month is documented, otherwise YYYY. null = unknown."},"year_to":{"type":["string","null"],"pattern":"^[0-9]{4}(-[0-9]{2})?$","description":"End of production in the same form. null = still in production or end unknown."},"years_label":{"type":["string","null"],"description":"Display text derived from year_from and year_to, e.g. \"2020 – 2022\", \"ab 2020\", \"03/2019 – 06/2022\"."},"display":{"type":"object","description":"Display names (brand, model, trim, series, series_code)."},"identity_only":{"type":"boolean","description":"true: only the official identity (HSN/TSN, brand, type) is known for this vehicle, no technical data yet."},"brand_id":{"type":"string","description":"Brand id as in /v2/brands (only when the brand is unambiguous)."},"brand_logo_url":{"type":"string","format":"uri","description":"Public logo of the brand (same file as logo_url in /v2/brands)."},"wheels":{"type":"object","properties":{"pcd":{"type":"string","description":"Bolt pattern, e.g. 5x112."},"pcd_status":{"type":"string","enum":["verified","unverified","missing"],"description":"verified: the value is confirmed; unverified: a value is present but not confirmed; missing: unknown."},"center_bore_mm":{"type":"number","description":"Center bore of the hub in mm."},"center_bore_status":{"type":"string","enum":["verified","unverified","missing"],"description":"verified, unverified or missing, as pcd_status."},"thread":{"type":"string","description":"Thread of the wheel bolts or nuts, e.g. M14X1.25."},"torque_nm":{"type":"number","description":"Tightening torque of the wheel bolts or nuts in Nm."},"fastener":{"type":"string","description":"German display text of the fastener (e.g. Radschrauben)."},"fastener_code":{"type":"string","enum":["bolts","nuts"],"description":"bolts or nuts."},"mounting":{"type":"object","description":"Further mounting details when documented."}},"description":"Wheel mounting of the vehicle: bolt pattern, center bore, thread, torque and fastener."},"tpms":{"type":"object","description":"Tire pressure monitoring: type (e.g. active) and whether wheels need a sensor."},"oe_tires":{"type":"array","items":{"type":"object"},"description":"Original equipment tires: size front (and rear, when different) with the matching wheel size."},"factory_wheels":{"type":"object","description":"Factory wheels from the certificate of conformity: references and wheel/tyre options; staggered = different front/rear size. Empty values are omitted.","properties":{"references":{"type":"array","items":{"type":"string"},"description":"Factory wheel sizes, e.g. \"7.5x17 ET30\"."},"options":{"type":"array","items":{"type":"object","properties":{"front":{"type":"string","description":"Tire size front (or all round)."},"rear":{"type":"string","description":"Tire size rear, only when it differs from front."},"front_wheel":{"type":"string","description":"Wheel size front (or all round), e.g. \"8.0x19 ET27\"."},"rear_wheel":{"type":"string","description":"Wheel size rear, only when it differs from front."},"staggered":{"type":"boolean","description":"true: different sizes front and rear."}}},"description":"Wheel and tire combinations from the certificate of conformity."}}},"has_wheels":{"type":"boolean","description":"true: the vehicle has wheel offers (/v2/vehicles/{vehicle_id}/wheels)."},"wheels_unavailable":{"type":"string","enum":["fitment_evidence_required","configuration_evidence_required","variant_facts_unavailable"],"description":"Present when no wheel statement is available for the vehicle without a selection; /wheels then answers with an empty list. A selection can still have wheels (selections[].wheels_available)."},"selections":{"type":"array","items":{"$ref":"#/components/schemas/Selection"},"description":"Selections of the vehicle: variants (var_…), EU configurations (cfg_…) and superseded keys (als_…). Send one as selection to narrow the result."},"configuration_count":{"type":"integer","description":"Number of EU configurations; the configurations themselves come from /v2/vehicles/{vehicle_id}/configurations."},"insurance":{"$ref":"#/components/schemas/Insurance","description":"Only with include=insurance: insurance type classes."},"insurance_unavailable":{"type":"string","enum":["no_type_classes"],"description":"Only with include=insurance: no insurance type classes are known for this vehicle."},"market":{"$ref":"#/components/schemas/IntelligenceMarket","description":"Only with include=market: official market figures for this vehicle."},"market_history":{"$ref":"#/components/schemas/IntelligenceMarketHistory","description":"Only with include=market_history: stock of this HSN/TSN per year."},"safety":{"$ref":"#/components/schemas/IntelligenceSafety","description":"Only with include=safety: recalls and safety figures."},"environment":{"$ref":"#/components/schemas/IntelligenceEnvironment","description":"Only with include=environment: environmental figures for exactly this HSN/TSN."},"intelligence_unavailable":{"type":"string","enum":["not_in_release"],"description":"Only with include=market, market_history, safety or environment: the active data release has none of the requested sections."},"data_sheet":{"$ref":"#/components/schemas/DataSheet","description":"Only with include=data_sheet: technical data sheet."},"data_sheet_unavailable":{"type":"string","enum":["no_data_sheet"],"description":"Only with include=data_sheet: no data sheet is known for this vehicle."},"vehicle_image":{"$ref":"#/components/schemas/VehicleImage","description":"Only with include=vehicle_image: preview image of the vehicle."},"selected":{"type":"object","description":"Only with the selection parameter: the applied selection (as in selections)."},"available_sections":{"type":"object","description":"Only with include=sections: which detail sections have content for this vehicle.","required":["workshop","market","recalls"],"properties":{"workshop":{"type":"boolean","description":"Fluid capacities in /technical."},"market":{"type":"boolean","description":"Official market figures (include=market)."},"recalls":{"type":"boolean","description":"Recalls (include=safety)."}}}}},"IntelligenceMetric":{"type":"object","required":["metric","status","scope","source","source_family","is_estimate"],"description":"One official figure. Empty values are omitted.","properties":{"metric":{"type":"string","description":"Stable metric name."},"value":{"type":"number"},"status":{"type":"string"},"unit":{"type":"string"},"period":{"type":"object","properties":{"grain":{"type":["string","null"]},"start":{"type":["string","null"]},"end":{"type":["string","null"]}}},"scope":{"type":"object","required":["hsn_tsn_exact"],"description":"What the figure refers to. hsn_tsn_exact=true: exactly this HSN/TSN.","properties":{"type":{"type":"string"},"key":{"type":"string"},"label":{"type":"string"},"brand":{"type":"string"},"tsn":{"type":"string"},"hsn_tsn_exact":{"type":"boolean"}}},"geography":{"type":"object","properties":{"type":{"type":"string"},"code":{"type":"string"},"key":{"type":"string"}}},"dimensions":{"type":"object","description":"Breakdown such as fuel or holder group.","additionalProperties":{"type":["string","number","boolean"]}},"source":{"type":"string","const":"official_statistics"},"source_family":{"type":"string","enum":["charging_infrastructure","vehicle_safety","vehicle_environment","road_traffic","vehicle_market","official_statistics"]},"quality":{"type":"string"},"is_estimate":{"type":"boolean"}}},"Recall":{"type":"object","required":["official_id","brand","model"],"description":"Official recall of the validated model. Empty values are omitted.","properties":{"official_id":{"type":"string"},"brand":{"type":"string"},"model":{"type":"string"},"production_from":{"type":"string"},"production_to":{"type":"string"},"published_at":{"type":"string"},"hazard":{"type":"string"},"measure":{"type":"string"},"status":{"type":"string"},"mapping_status":{"type":"string"},"confidence":{"type":"number","description":"How surely the recall matches the model (0 to 1)."}}},"IntelligenceMarket":{"type":"object","required":["latest","scope"],"description":"include=market: newest figure per metric for this vehicle; never brand, region or class aggregates.","properties":{"latest":{"type":"array","items":{"$ref":"#/components/schemas/IntelligenceMetric"}},"scope":{"type":"string"},"reason":{"type":"string","description":"Why latest is empty."}}},"IntelligenceMarketHistory":{"type":"object","required":["available","scope"],"description":"include=market_history: stock of exactly this HSN/TSN per year (official count on 1 January) and the trend calculated from these counts. Empty values are omitted; a figure whose years are not in the series is left out, never estimated.","properties":{"available":{"type":"boolean"},"scope":{"type":"string"},"hsn_tsn_exact":{"type":"boolean"},"registration_history":{"type":"array","description":"Registered vehicles of this HSN/TSN per year, oldest first.","items":{"type":"object","required":["year","registered"],"properties":{"year":{"type":"integer","description":"Reference year (stock on 1 January of that year)."},"registered":{"type":"number","description":"Registered vehicles."}}}},"registration_trend":{"type":"object","description":"Change of the stock in percent, calculated from registration_history.","properties":{"year_over_year":{"$ref":"#/components/schemas/StockChange"},"average_per_year":{"$ref":"#/components/schemas/StockChange"}}},"reason":{"type":"string","description":"Why nothing is available."}}},"StockChange":{"type":"object","required":["change_pct","from_year","to_year"],"description":"Change of the stock between two years of registration_history.","properties":{"change_pct":{"type":"number","description":"year_over_year: change from from_year to to_year in percent. average_per_year: average change per year between from_year and to_year in percent, rounded to 2 decimals."},"from_year":{"type":"integer"},"to_year":{"type":"integer"}}},"IntelligenceSafety":{"type":"object","required":["available","scope","hsn_tsn_exact","recall_count","recalls"],"description":"include=safety: recalls of the validated model (up to 200, newest first) and exact safety figures.","properties":{"available":{"type":"boolean"},"scope":{"type":"string"},"hsn_tsn_exact":{"type":"boolean"},"recall_count":{"type":"integer","minimum":0},"recalls":{"type":"array","items":{"$ref":"#/components/schemas/Recall"}},"facts":{"type":"array","items":{"$ref":"#/components/schemas/IntelligenceMetric"}},"reason":{"type":"string","description":"Why nothing is available."}}},"IntelligenceEnvironment":{"type":"object","required":["available","scope","hsn_tsn_exact","latest"],"description":"include=environment: only figures that refer exactly to this HSN/TSN.","properties":{"available":{"type":"boolean"},"scope":{"type":"string"},"hsn_tsn_exact":{"type":"boolean"},"latest":{"type":"array","items":{"$ref":"#/components/schemas/IntelligenceMetric"}},"reason":{"type":"string","description":"Why nothing is available."}}},"DataSheet":{"type":"object","description":"include=data_sheet. Numbers are numbers; the unit is part of the field name. Values that cannot be read exactly are omitted, never guessed.","properties":{"sheets":{"type":"array","description":"One data sheet per VSN.","items":{"$ref":"#/components/schemas/DataSheetEntry"}},"facts":{"type":"object","description":"Vehicle facts by name (e.g. length_mm, curb_weight_kg, drivetrain). values only when status is confirmed.","additionalProperties":{"type":"object","required":["status"],"properties":{"status":{"type":"string","enum":["confirmed","unresolved","unknown"]},"values":{"type":"array","items":{"type":["number","string"]}}}}}}},"DataSheetEntry":{"type":"object","description":"Data sheet of one VSN. Number fields can also appear as <name>_min and <name>_max when the value is a range.","properties":{"vsn":{"type":"string"},"type_approval_number":{"type":"string"},"body_label":{"type":"string"},"engine_label":{"type":"string"},"engine_code":{"type":"string"},"transmission_label":{"type":"string"},"doors":{"type":"integer"},"seats":{"type":"integer"},"fuel_code":{"type":"string","enum":["petrol","diesel","electric","hybrid","mild_hybrid","plugin_hybrid","lpg","cng","hydrogen","other"],"description":"Code list fuel. Missing when unknown."},"fuel_label":{"type":"string","description":"German label of fuel_code (petrol = Benzin, diesel = Diesel, electric = Elektro, hybrid = Hybrid, mild_hybrid = Mild-Hybrid, plugin_hybrid = Plug-in-Hybrid, lpg = Autogas (LPG), cng = Erdgas (CNG), hydrogen = Wasserstoff, other = Sonstiger Kraftstoff)."},"drivetrain_code":{"type":"string","enum":["front","rear","all"],"description":"Code list drivetrain. Missing when unknown."},"drivetrain_label":{"type":"string","description":"German label of drivetrain_code (front = Frontantrieb, rear = Heckantrieb, all = Allradantrieb)."},"production":{"type":"object","required":["start_year","end_status"],"properties":{"start_year":{"type":"integer"},"end_year":{"type":"integer"},"end_status":{"type":"string","enum":["documented","ongoing"]}}},"power_kw":{"type":"number"},"power_ps":{"type":"number"},"displacement_ccm":{"type":"number","description":"ccm"},"displacement_ccm_min":{"type":"number","description":"ccm"},"displacement_ccm_max":{"type":"number","description":"ccm"},"top_speed_kmh":{"type":"number","description":"km/h"},"top_speed_kmh_min":{"type":"number","description":"km/h"},"top_speed_kmh_max":{"type":"number","description":"km/h"},"max_torque_nm":{"type":"number","description":"Nm"},"max_torque_nm_min":{"type":"number","description":"Nm"},"max_torque_nm_max":{"type":"number","description":"Nm"},"rated_speed_rpm":{"type":"number","description":"rpm"},"rated_speed_rpm_min":{"type":"number","description":"rpm"},"rated_speed_rpm_max":{"type":"number","description":"rpm"},"system_torque_nm":{"type":"number","description":"Nm"},"system_torque_nm_min":{"type":"number","description":"Nm"},"system_torque_nm_max":{"type":"number","description":"Nm"},"combustion_torque_nm":{"type":"number","description":"Nm"},"combustion_torque_nm_min":{"type":"number","description":"Nm"},"combustion_torque_nm_max":{"type":"number","description":"Nm"},"combustion_rated_speed_rpm":{"type":"number","description":"rpm"},"combustion_rated_speed_rpm_min":{"type":"number","description":"rpm"},"combustion_rated_speed_rpm_max":{"type":"number","description":"rpm"},"combustion_max_torque_speed_rpm":{"type":"number","description":"rpm"},"combustion_max_torque_speed_rpm_min":{"type":"number","description":"rpm"},"combustion_max_torque_speed_rpm_max":{"type":"number","description":"rpm"},"co2_nedc_g_km":{"type":"number","description":"g/km"},"co2_nedc_g_km_min":{"type":"number","description":"g/km"},"co2_nedc_g_km_max":{"type":"number","description":"g/km"},"co2_wltp_combined_g_km":{"type":"number","description":"g/km"},"co2_wltp_combined_g_km_min":{"type":"number","description":"g/km"},"co2_wltp_combined_g_km_max":{"type":"number","description":"g/km"},"co2_wltp_phev_depleted_g_km":{"type":"number","description":"g/km"},"co2_wltp_phev_depleted_g_km_min":{"type":"number","description":"g/km"},"co2_wltp_phev_depleted_g_km_max":{"type":"number","description":"g/km"},"length_cm":{"type":"number","description":"cm"},"length_cm_min":{"type":"number","description":"cm"},"length_cm_max":{"type":"number","description":"cm"},"width_cm":{"type":"number","description":"cm"},"width_cm_min":{"type":"number","description":"cm"},"width_cm_max":{"type":"number","description":"cm"},"height_cm":{"type":"number","description":"cm"},"height_cm_min":{"type":"number","description":"cm"},"height_cm_max":{"type":"number","description":"cm"},"curb_weight_kg":{"type":"number","description":"kg"},"curb_weight_kg_min":{"type":"number","description":"kg"},"curb_weight_kg_max":{"type":"number","description":"kg"},"gross_weight_kg":{"type":"number","description":"kg"},"gross_weight_kg_min":{"type":"number","description":"kg"},"gross_weight_kg_max":{"type":"number","description":"kg"},"permitted_gross_weight_kg":{"type":"number","description":"kg"},"permitted_gross_weight_kg_min":{"type":"number","description":"kg"},"permitted_gross_weight_kg_max":{"type":"number","description":"kg"},"axle_load_front_kg":{"type":"number","description":"kg"},"axle_load_front_kg_min":{"type":"number","description":"kg"},"axle_load_front_kg_max":{"type":"number","description":"kg"},"axle_load_rear_kg":{"type":"number","description":"kg"},"axle_load_rear_kg_min":{"type":"number","description":"kg"},"axle_load_rear_kg_max":{"type":"number","description":"kg"},"towing_braked_kg":{"type":"number","description":"kg"},"towing_braked_kg_min":{"type":"number","description":"kg"},"towing_braked_kg_max":{"type":"number","description":"kg"},"towing_unbraked_kg":{"type":"number","description":"kg"},"towing_unbraked_kg_min":{"type":"number","description":"kg"},"towing_unbraked_kg_max":{"type":"number","description":"kg"},"nose_weight_kg":{"type":"number","description":"kg"},"nose_weight_kg_min":{"type":"number","description":"kg"},"nose_weight_kg_max":{"type":"number","description":"kg"},"engine_oil_capacity_l":{"type":"number","description":"l"},"engine_oil_capacity_l_min":{"type":"number","description":"l"},"engine_oil_capacity_l_max":{"type":"number","description":"l"},"coolant_capacity_l":{"type":"number","description":"l"},"coolant_capacity_l_min":{"type":"number","description":"l"},"coolant_capacity_l_max":{"type":"number","description":"l"},"manual_transmission_oil_capacity_l":{"type":"number","description":"l"},"manual_transmission_oil_capacity_l_min":{"type":"number","description":"l"},"manual_transmission_oil_capacity_l_max":{"type":"number","description":"l"},"automatic_transmission_oil_capacity_l":{"type":"number","description":"l"},"automatic_transmission_oil_capacity_l_min":{"type":"number","description":"l"},"automatic_transmission_oil_capacity_l_max":{"type":"number","description":"l"},"brake_fluid_capacity_l":{"type":"number","description":"l"},"brake_fluid_capacity_l_min":{"type":"number","description":"l"},"brake_fluid_capacity_l_max":{"type":"number","description":"l"}}},"RegistrationObservation":{"type":"object","description":"Annual registration statistics of a configuration. Empty values are omitted.","required":["observation_id","measurement_basis","context","rows","represented_registrations","unknown_registration_count_rows","unknown_registration_date_rows","combinations"],"properties":{"observation_id":{"type":"string","pattern":"^[a-f0-9]{64}$"},"measurement_basis":{"type":"string","const":"annual_registration_statistics"},"context":{"type":"object","required":["year","country","provisional"],"properties":{"year":{"type":"integer"},"country":{"type":"string","pattern":"^[A-Z]{2}$"},"provisional":{"type":"boolean"}}},"rows":{"type":"integer","minimum":0},"represented_registrations":{"type":"integer","minimum":0},"unknown_registration_count_rows":{"type":"integer","minimum":0},"unknown_registration_date_rows":{"type":"integer","minimum":0},"earliest_registration_date":{"type":"string","description":"YYYY-MM-DD; missing when no date is known."},"latest_registration_date":{"type":"string","description":"YYYY-MM-DD; missing when no date is known."},"combinations":{"type":"array","items":{"type":"object","required":["combination_id","rows","represented_registrations","unknown_registration_count_rows","unknown_registration_date_rows","measurements"],"properties":{"combination_id":{"type":"string","pattern":"^[a-f0-9]{64}$"},"rows":{"type":"integer","minimum":0},"represented_registrations":{"type":"integer","minimum":0},"unknown_registration_count_rows":{"type":"integer","minimum":0},"unknown_registration_date_rows":{"type":"integer","minimum":0},"earliest_registration_date":{"type":"string","description":"YYYY-MM-DD; missing when no date is known."},"latest_registration_date":{"type":"string","description":"YYYY-MM-DD; missing when no date is known."},"measurements":{"type":"array","items":{"type":"object","required":["field","value","unit_status"],"properties":{"field":{"type":"string","enum":["running_order_mass","wltp_test_mass","engine_power","electric_energy_consumption","electric_range","fuel_consumption","engine_displacement","specific_co2_wltp","specific_co2_nedc"]},"value":{"type":"number","minimum":0},"unit":{"type":["string","null"]},"unit_status":{"type":"string","enum":["documented","not_documented"],"description":"not_documented: no unit is documented; unit is then null or missing."}}}}}}}}},"Insurance":{"type":"object","description":"Insurance type classes per HSN/TSN (include=insurance and /v2/insurance). All classes are integers; a value that is not a whole number in the data is omitted, never guessed. Empty values are omitted.","properties":{"liability":{"type":"integer","minimum":0,"description":"Current liability (third-party) type class."},"partial_comprehensive":{"type":"integer","minimum":0,"description":"Current partial comprehensive type class."},"full_comprehensive":{"type":"integer","minimum":0,"description":"Current full comprehensive type class."},"year":{"type":"integer","minimum":1900,"description":"Year of the current type classes: the latest year (YYYY) in history across all lines. Omitted without history."},"history":{"type":"object","description":"Type class per line and year (key YYYY).","properties":{"liability":{"type":"object","additionalProperties":{"type":"integer","minimum":0}},"partial_comprehensive":{"type":"object","additionalProperties":{"type":"integer","minimum":0}},"full_comprehensive":{"type":"object","additionalProperties":{"type":"integer","minimum":0}}}}}},"InsuranceListItem":{"type":"object","required":["vehicle_id","hsn","tsn","insurance"],"properties":{"vehicle_id":{"type":"string"},"hsn":{"type":"string"},"tsn":{"type":"string"},"brand":{"type":"string","description":"As on /v2/vehicles/{vehicle_id}."},"model":{"type":"string","description":"As on /v2/vehicles/{vehicle_id}."},"insurance":{"$ref":"#/components/schemas/Insurance"}}},"Selection":{"type":"object","required":["selection_id","kind"],"properties":{"selection_id":{"type":"string","description":"Id of the selection. Send it unchanged as selection; never build it yourself."},"kind":{"type":"string","enum":["variant","configuration","alias","execution"],"description":"variant (var_…), configuration (cfg_…, EU configuration) or alias (als_…, superseded key with several successors)."},"label":{"type":"string","description":"Variants: display name."},"wheels_available":{"type":"boolean","description":"false: /wheels with this selection answers with an empty list and unavailable_reason (no wheel statement for it)."},"unavailable_reason":{"type":"string","enum":["fitment_evidence_required","configuration_evidence_required","variant_facts_unavailable"],"description":"Only when no statement is available: fitment_evidence_required (no verified wheel data for the vehicle), configuration_evidence_required (the selection needs verified data of an EU configuration), variant_facts_unavailable (no verified facts for this variant). An empty list with this reason means \"no statement\", never \"nothing fits\"."},"year_from":{"type":["string","null"],"pattern":"^[0-9]{4}(-[0-9]{2})?$","description":"Start of production, YYYY-MM when the month is documented, otherwise YYYY. null = unknown."},"year_to":{"type":["string","null"],"pattern":"^[0-9]{4}(-[0-9]{2})?$","description":"End of production in the same form. null = still in production or end unknown."},"years_label":{"type":["string","null"],"description":"Display text derived from year_from and year_to, e.g. \"2020 – 2022\", \"ab 2020\", \"03/2019 – 06/2022\"."},"vsns":{"type":"array","items":{"type":"string"},"description":"Variants only: VSNs (field 2.2, positions 4–8) of this variant; use with the vsn parameter."},"body_type_code":{"type":"string","enum":["sedan","hatchback","fastback","estate","coupe","convertible","suv","van","pickup","panel_van"],"description":"Code list body_type. Missing when unknown."},"body_type_label":{"type":"string","description":"German label of body_type_code (sedan = Limousine, hatchback = Schrägheck, fastback = Fließheck, estate = Kombi, coupe = Coupé, convertible = Cabrio, suv = SUV / Geländewagen, van = Van, pickup = Pick-up, panel_van = Transporter)."},"fuel_code":{"type":"string","enum":["petrol","diesel","electric","hybrid","mild_hybrid","plugin_hybrid","lpg","cng","hydrogen","other"],"description":"Code list fuel. Missing when unknown."},"fuel_label":{"type":"string","description":"German label of fuel_code (petrol = Benzin, diesel = Diesel, electric = Elektro, hybrid = Hybrid, mild_hybrid = Mild-Hybrid, plugin_hybrid = Plug-in-Hybrid, lpg = Autogas (LPG), cng = Erdgas (CNG), hydrogen = Wasserstoff, other = Sonstiger Kraftstoff)."},"drivetrain_code":{"type":"string","enum":["front","rear","all"],"description":"Code list drivetrain. Missing when unknown."},"drivetrain_label":{"type":"string","description":"German label of drivetrain_code (front = Frontantrieb, rear = Heckantrieb, all = Allradantrieb)."},"body_types":{"type":"array","description":"Variants whose executions differ in body: one entry per execution; body_type_code only when decided for exactly this execution.","items":{"type":"object","required":["vsn"],"properties":{"vsn":{"type":"string","description":"VSN of the execution (field 2.2, positions 4–8)."},"body_type_code":{"type":"string","enum":["sedan","hatchback","fastback","estate","coupe","convertible","suv","van","pickup","panel_van"],"description":"Code list body_type. Missing when unknown."},"body_type_label":{"type":"string","description":"German label of body_type_code (sedan = Limousine, hatchback = Schrägheck, fastback = Fließheck, estate = Kombi, coupe = Coupé, convertible = Cabrio, suv = SUV / Geländewagen, van = Van, pickup = Pick-up, panel_van = Transporter)."},"length_mm":{"type":"integer","description":"Length of this execution in mm."},"height_mm":{"type":"integer","description":"Height of this execution in mm."}}}},"variant_selection_ids":{"type":"array","items":{"type":"string"},"description":"The variants (var_…) this selection stands for."},"variant_selection_id":{"type":"string","description":"Configurations only: linked variant selection, when documented. Keep its technical profile separate from the configuration observations."},"technical_observations":{"type":"array","description":"Configurations only: documented technical values of this EU configuration (value or minimum/maximum, unit, basis). confirmed=false marks a value that is not confirmed by further data; confirmed values carry no such field.","items":{"type":"object","required":["field","measurement_basis"],"properties":{"field":{"type":"string","description":"Name of the technical value, e.g. power or displacement."},"value":{"type":["number","string"],"description":"For body_type, drive_layout and propulsion: the code of the body type, drivetrain or fuel code list."},"label":{"type":"string","description":"For coded values: the German label of the code."},"minimum":{"type":"number","description":"Smallest value when the value is a range."},"maximum":{"type":"number","description":"Largest value when the value is a range."},"unit":{"type":"string","description":"Unit of the value."},"measurement_basis":{"type":"string","description":"What the value refers to (measurement basis)."},"context":{"type":"object","description":"Further context of the value when documented."},"confirmed":{"type":"boolean","const":false,"description":"Present (false) only when the value is not confirmed by further data."}}}},"approval_observations":{"type":"array","description":"Configurations only: reported withdrawal records of the type approval.","items":{"type":"object","required":["kind","scope","record_position","reported_start"],"properties":{"kind":{"type":"string","description":"Kind of record."},"scope":{"type":"string","description":"What the record refers to."},"record_position":{"type":"string","description":"Position of the record in the reported list."},"reported_start":{"type":"string","description":"Reported start date."},"reported_end":{"type":"string","description":"Reported end date, when given."}}}},"approval_validity":{"type":"string","enum":["not_determined"],"description":"not_determined: the validity of the type approval is not determined from these records."},"registration_observations":{"type":"array","description":"Configurations only: annual registration statistics (documented counts and measured values). A response carries at most about 1.5 MB of observations; a configuration that does not fit continues on the next page (same selection_id, follow meta.next_cursor and append).","items":{"$ref":"#/components/schemas/RegistrationObservation"}},"registration_observations_complete":{"type":"boolean","description":"Only when the statistics of this configuration are split over pages: false = more observations follow on the next page."},"registration_observations_offset":{"type":"integer","minimum":0,"description":"Only when split over pages: number of observations of this configuration delivered on earlier pages."}}},"Tire":{"type":"object","required":["size","axle","status"],"properties":{"size":{"type":"string","description":"Tire size, e.g. 225/40R19."},"axle":{"type":"string","enum":["front","rear","both"],"description":"front, rear or both (all round)."},"status":{"type":"string","enum":["no_registration","registration_required","unknown","not_fitting"],"description":"Fitment status of this tire on this wheel."},"load_index":{"type":["string","number"],"description":"Minimum load index, when the document names one."},"obligations":{"type":"array","items":{"type":"string"},"description":"Codes of the conditions and notes of the document for this tire. The texts are in the document (obligations)."},"blocking_obligations":{"type":"array","items":{"type":"string"},"description":"Only with status not_fitting: the codes that rule the combination out."},"open_obligations":{"type":"array","items":{"type":"string"},"description":"Only with status unknown: the codes that could not be decided from the vehicle data."},"reason":{"type":"string","enum":["equipment_conditions_apply","installation_conditions_apply","registration_required","requires_configuration_evidence","requires_configuration_document_evidence","requires_configuration_power_evidence","requires_geometry_evidence","conditions_unresolved","power_outside_document_range","blocked_by_conditions","geometry_mismatch"],"description":"Why the status applies. Per status: no_registration: equipment_conditions_apply, installation_conditions_apply; registration_required: registration_required; unknown: requires_configuration_evidence, requires_configuration_document_evidence, requires_configuration_power_evidence, requires_geometry_evidence, conditions_unresolved; not_fitting: power_outside_document_range, blocked_by_conditions, geometry_mismatch."},"violated_conditions":{"type":"array","description":"Only with status not_fitting: which condition the vehicle does not meet."},"requires_bodywork":{"type":"boolean","description":"true: the document requires work on the body (e.g. wheel arch) for this tire."},"hints":{"type":"array","items":{"type":"string"},"description":"Notes of the document row as text."},"power_kw_min":{"type":"integer","description":"Power range of the document row in kW (one value: min = max)."},"power_kw_max":{"type":"integer","description":"Largest power of the document row in kW."},"power_kw_values":{"type":"array","items":{"type":"integer"},"description":"Only when the document lists single values: exactly these; power_kw_min/max are the smallest and largest."},"power_kw_text":{"type":"string","description":"Only when the document value cannot be read as whole numbers; then without power_kw_min/max."}}},"Offer":{"type":"object","required":["offer_id","wheel_code","status"],"properties":{"offer_id":{"type":"string","description":"Id of the offer (one wheel size with ET on this vehicle)."},"wheel_code":{"type":"string","description":"Wheel code from the wheel catalog (/v2/wheels/{wheel_code})."},"width_inch":{"type":"number","description":"Rim width in inches."},"diameter_inch":{"type":"number","description":"Rim diameter in inches."},"et_mm":{"type":"number","description":"Offset (ET) in mm."},"pcd":{"type":"string","description":"Bolt pattern of the wheel, e.g. 5x112."},"center_bore_mm":{"type":"number","description":"Center bore of the wheel in mm."},"axle":{"type":"string","enum":["front","rear","both"],"description":"front/rear: this axle only (own offer_id)."},"status":{"type":"string","enum":["no_registration","registration_required","unknown","not_fitting"],"description":"Fitment status: no_registration (no registration needed), registration_required, unknown or not_fitting. The best status of the tires on this wheel."},"reason":{"type":"string","enum":["equipment_conditions_apply","installation_conditions_apply","registration_required","requires_configuration_evidence","requires_configuration_document_evidence","requires_configuration_power_evidence","requires_geometry_evidence","conditions_unresolved","power_outside_document_range","blocked_by_conditions","geometry_mismatch"],"description":"Why the status applies. Per status: no_registration: equipment_conditions_apply, installation_conditions_apply; registration_required: registration_required; unknown: requires_configuration_evidence, requires_configuration_document_evidence, requires_configuration_power_evidence, requires_geometry_evidence, conditions_unresolved; not_fitting: power_outside_document_range, blocked_by_conditions, geometry_mismatch."},"match":{"type":"string","enum":["vehicle","geometry_only"],"description":"vehicle: the document names this vehicle; geometry_only: the document applies through matching wheel geometry."},"document_ids":{"type":"array","items":{"type":"string"},"description":"Approval documents (doc_…) behind this offer; texts with view=full in included.documents or via /v2/documents/{document_id}."},"centering":{"type":"object","description":"Centering: center bores of vehicle and wheel and whether a centering ring is required."},"selection_recommended":{"type":"boolean","description":"true: the result depends on the EU configuration; sending a selection gives a more precise status."},"fits_selections":{"type":"array","items":{"type":"string"},"description":"Without a selection only, with status unknown and reason requires_configuration_evidence: the offer is not positive for every variant of the vehicle, but for these variants (selection_id var_…). Request the offer again with one of them as selection."},"tire_combination":{"type":"string","enum":["single","mixed_optional","mixed_required","restricted_pairs"],"description":"How tires combine across axles on this wheel: single (one size per vehicle, axle of each tire still applies), mixed_optional, mixed_required (front and rear sizes differ), restricted_pairs (only the pairs in allowed_pairs)."},"tires":{"type":"array","items":{"$ref":"#/components/schemas/Tire"},"description":"view=full only"},"tire_sizes":{"type":"array","items":{"type":"string"},"description":"view=summary only"},"allowed_pairs":{"type":"array","description":"view=full only. Front/rear tire pairs on this wheel that the document allows only as a pair (obligation code, e.g. V18). When present, combine front and rear tires only as listed.","items":{"type":"object","required":["front_tire","rear_tire","obligation"],"properties":{"front_tire":{"type":"string","description":"Tire size front."},"rear_tire":{"type":"string","description":"Tire size rear."},"obligation":{"type":"string","description":"Code of the condition that allows this pair."}}}}}},"WheelSet":{"type":"object","required":["set_id","status"],"properties":{"set_id":{"type":"string","description":"Id of the axle pair."},"document_id":{"type":"string","description":"Document that allows this pair."},"front_offer_id":{"type":"string","description":"Offer on the front axle."},"rear_offer_id":{"type":"string","description":"Offer on the rear axle."},"front_tire":{"type":"string","description":"Tire size front."},"rear_tire":{"type":"string","description":"Tire size rear."},"front_status":{"type":"string","enum":["no_registration","registration_required","unknown","not_fitting"],"description":"Fitment status front."},"rear_status":{"type":"string","enum":["no_registration","registration_required","unknown","not_fitting"],"description":"Fitment status rear."},"status":{"type":"string","enum":["no_registration","registration_required","unknown","not_fitting"],"description":"Fitment status of the pair."},"obligations":{"type":"array","items":{"type":"string"},"description":"Codes of the conditions that apply to the pair."}}},"Included":{"type":"object","description":"view=full only","properties":{"sets":{"type":"array","items":{"$ref":"#/components/schemas/WheelSet"},"description":"Axle pairs: front and rear offers that may only be combined as listed."},"documents":{"type":"object","description":"Documents of the offers by document_id, each with approval data and the condition texts (obligations)."}}},"Document":{"type":"object","required":["document_id"],"properties":{"document_id":{"type":"string","description":"Document id (doc_ and 24 hex characters)."},"approval_type":{"type":"string","description":"Kind of approval, e.g. KBA, ABE, ECE or TTG."},"approval_number":{"type":"string","description":"Approval number."},"kba_number":{"type":"string","description":"KBA number of the approval, when known."},"obligations":{"type":"object","additionalProperties":{"type":"string"},"description":"Conditions and notes of the document: text per code (e.g. A12). Show all texts that apply to the chosen tire."},"url":{"type":["string","null"],"description":"Link to the PDF of the document; null when not available."}}},"MetaSearch":{"type":"object","required":["api_version","data_version","next_cursor","total"],"properties":{"api_version":{"type":"integer"},"data_version":{"type":"string"},"next_cursor":{"type":["string","null"]},"total":{"type":"integer"},"engine_code":{"type":"string"},"facets":{"type":"object","additionalProperties":{"type":"array","items":{"type":"object","required":["value","count"],"properties":{"value":{"type":"string"},"count":{"type":"integer"}}}}}}},"VehicleVariant":{"type":"object","required":["completeness"],"properties":{"vehicle_id":{"type":"string","description":"Vehicle id (HSN-TSN) of the variant."},"selection_id":{"type":"string","description":"Variant selection id when the variant is a selection of the vehicle."},"brand":{"type":"string","description":"Brand."},"model":{"type":"string","description":"Model."},"label":{"type":"string","description":"Display name of the variant, e.g. 118d."},"body_type_code":{"type":"string","enum":["sedan","hatchback","fastback","estate","coupe","convertible","suv","van","pickup","panel_van"],"description":"Code list body_type. Missing when unknown."},"body_type_label":{"type":"string","description":"German label of body_type_code (sedan = Limousine, hatchback = Schrägheck, fastback = Fließheck, estate = Kombi, coupe = Coupé, convertible = Cabrio, suv = SUV / Geländewagen, van = Van, pickup = Pick-up, panel_van = Transporter)."},"fuel_code":{"type":"string","enum":["petrol","diesel","electric","hybrid","mild_hybrid","plugin_hybrid","lpg","cng","hydrogen","other"],"description":"Code list fuel. Missing when unknown."},"fuel_label":{"type":"string","description":"German label of fuel_code (petrol = Benzin, diesel = Diesel, electric = Elektro, hybrid = Hybrid, mild_hybrid = Mild-Hybrid, plugin_hybrid = Plug-in-Hybrid, lpg = Autogas (LPG), cng = Erdgas (CNG), hydrogen = Wasserstoff, other = Sonstiger Kraftstoff)."},"transmission_code":{"type":"string","enum":["manual","automatic","dual_clutch","automated_manual","cvt","single_speed"],"description":"Code list transmission. Missing when unknown."},"transmission_label":{"type":"string","description":"German label of transmission_code (manual = Schaltgetriebe, automatic = Automatikgetriebe, dual_clutch = Doppelkupplungsgetriebe, automated_manual = Automatisiertes Schaltgetriebe, cvt = Stufenloses Getriebe (CVT), single_speed = Eingang-Getriebe)."},"drivetrain_code":{"type":"string","enum":["front","rear","all"],"description":"Code list drivetrain. Missing when unknown."},"drivetrain_label":{"type":"string","description":"German label of drivetrain_code (front = Frontantrieb, rear = Heckantrieb, all = Allradantrieb)."},"year_from":{"type":["string","null"],"pattern":"^[0-9]{4}(-[0-9]{2})?$","description":"Start of production, YYYY-MM when the month is documented, otherwise YYYY. null = unknown."},"year_to":{"type":["string","null"],"pattern":"^[0-9]{4}(-[0-9]{2})?$","description":"End of production in the same form. null = still in production or end unknown."},"years_label":{"type":["string","null"],"description":"Display text derived from year_from and year_to, e.g. \"2020 – 2022\", \"ab 2020\", \"03/2019 – 06/2022\"."},"body":{"type":"object","properties":{"doors":{"type":"integer","description":"Number of doors."},"seats":{"type":"integer","description":"Number of seats."}},"description":"Body: doors and seats."},"dimensions":{"type":"object","properties":{"length_mm":{"type":"integer","description":"Length in mm."},"width_mm":{"type":"integer","description":"Width in mm."},"height_mm":{"type":"integer","description":"Height in mm."}},"description":"Outer dimensions."},"powertrain":{"type":"object","properties":{"power_kw":{"type":"integer","description":"Power in kW."},"power_ps":{"type":"integer","description":"Power in PS."},"displacement_ccm":{"type":"integer","description":"Displacement in ccm."}},"description":"Power and displacement."},"weights":{"type":"object","properties":{"curb_kg":{"type":"integer","description":"Curb weight in kg."},"gross_kg":{"type":"integer","description":"Gross vehicle weight in kg."}},"description":"Weights."},"towing":{"type":"object","properties":{"braked_kg":{"type":"integer","description":"Braked trailer load in kg."},"unbraked_kg":{"type":"integer","description":"Unbraked trailer load in kg."},"nose_weight_kg":{"type":"integer","description":"Permitted nose weight in kg."}},"description":"Towing capacity. Trailer limits are variant-specific; the registration certificate is authoritative."},"engine":{"type":"object","properties":{"type":{"type":"string","description":"German display text of the engine type (e.g. Dieselmotor)."},"codes":{"type":"array","items":{"type":"string"},"description":"Engine codes as documented."},"codes_normalized":{"type":"array","items":{"type":"string"},"description":"Engine codes in a uniform spelling (capitals, no spaces) for search and comparison."}},"description":"Engine type and engine codes."},"completeness":{"type":"integer","description":"Number of documented technical fields."}}},"EngineProfile":{"type":"object","properties":{"code":{"type":"string"},"type":{"type":"string"},"displacement_ccm":{"type":"integer"},"power_kw":{"type":"integer"},"fluids":{"type":"object","properties":{"engine_oil_l":{"type":"number"},"coolant_l":{"type":"number"},"manual_transmission_l":{"type":"number"},"automatic_transmission_l":{"type":"number"},"brake_fluid_l":{"type":"number"}}},"axle_loads":{"type":"object","properties":{"front_kg":{"type":"integer"},"rear_kg":{"type":"integer"}}},"documented_fields":{"type":"array","items":{"type":"string"}}}},"VehicleTechnical":{"type":"object","required":["vehicle_id","variants"],"properties":{"vehicle_id":{"type":"string"},"brand":{"type":"string"},"model":{"type":"string"},"wheel_mounting":{"type":"object","description":"Same as wheels on /v2/vehicles/{vehicle_id}."},"safety_note":{"type":"string"},"engines_unavailable":{"type":"string","enum":["configuration_evidence_required"],"description":"Engine rows (fluid capacities, axle loads) are withheld because the vehicle has several EU configurations without verified assignment."},"variants":{"type":"array","items":{"allOf":[{"$ref":"#/components/schemas/VehicleVariant"},{"type":"object","properties":{"engines":{"type":"array","items":{"$ref":"#/components/schemas/EngineProfile"}}}}]}}}},"VehicleWorkshopProfile":{"type":"object","required":["vehicle_id","profile_basis"],"properties":{"vehicle_id":{"type":"string"},"brand":{"type":"string"},"model":{"type":"string"},"profile_basis":{"type":"string","enum":["variant","configuration"],"description":"variant: variants with engine rows as in /technical; configuration: the documented values of the selected EU configuration."},"wheel_mounting":{"type":"object","description":"profile_basis variant only: same as wheels on /v2/vehicles/{vehicle_id}."},"safety_note":{"type":"string"},"engines_unavailable":{"type":"string","enum":["configuration_evidence_required"],"description":"profile_basis variant only: engine rows are withheld because the vehicle has several EU configurations without verified assignment. Request the profile with one of its configurations (cfg_…) as selection."},"variants":{"type":"array","description":"profile_basis variant only.","items":{"allOf":[{"$ref":"#/components/schemas/VehicleVariant"},{"type":"object","properties":{"engines":{"type":"array","items":{"$ref":"#/components/schemas/EngineProfile"}}}}]}},"configuration":{"allOf":[{"$ref":"#/components/schemas/Selection"}],"description":"profile_basis configuration only: the selected EU configuration as in /configurations (without registration statistics)."},"configuration_profile":{"type":"object","description":"profile_basis configuration only: values documented for this configuration.","properties":{"displacement_ccm":{"type":"integer","description":"Engine displacement, when exactly one value is documented."},"axle_loads":{"type":"object","description":"Technically permissible axle loads, when exactly one value is documented per axle.","properties":{"front_kg":{"type":"integer"},"rear_kg":{"type":"integer"}}},"documented_fields":{"type":"array","items":{"type":"string"},"description":"Names of all technical values documented for this configuration."}}},"profile_unavailable":{"type":"string","enum":["configuration_evidence_required"],"description":"profile_basis configuration only: the configuration has no documented technical values."}}},"VehicleCompareItem":{"type":"object","required":["vehicle_id","variants"],"properties":{"vehicle_id":{"type":"string"},"brand":{"type":"string"},"model":{"type":"string"},"not_found":{"type":"boolean","const":true,"description":"Only when the vehicle id is unknown; variants is then empty."},"variants":{"type":"array","items":{"$ref":"#/components/schemas/VehicleVariant"},"description":"Documented variants of the vehicle (or the selected one), ordered as in /technical."}}},"EngineCode":{"type":"object","required":["engine_code","vehicle_count","application_count"],"properties":{"engine_code":{"type":"string"},"display_code":{"type":"string"},"engine_type":{"type":"string"},"fuel_code":{"type":"string","enum":["petrol","diesel","electric","hybrid","mild_hybrid","plugin_hybrid","lpg","cng","hydrogen","other"],"description":"Code list fuel. Missing when unknown."},"fuel_label":{"type":"string","description":"German label of fuel_code (petrol = Benzin, diesel = Diesel, electric = Elektro, hybrid = Hybrid, mild_hybrid = Mild-Hybrid, plugin_hybrid = Plug-in-Hybrid, lpg = Autogas (LPG), cng = Erdgas (CNG), hydrogen = Wasserstoff, other = Sonstiger Kraftstoff)."},"displacement_ccm":{"type":"integer"},"power_kw_min":{"type":"integer"},"power_kw_max":{"type":"integer"},"vehicle_count":{"type":"integer"},"application_count":{"type":"integer"}}},"DocumentListItem":{"type":"object","required":["document_id","wheel_code"],"properties":{"document_id":{"type":"string","description":"Document id (doc_ and 24 hex characters)."},"wheel_code":{"type":"string","description":"Wheel code the document belongs to."},"approval_type":{"type":"string","description":"Kind of approval, e.g. KBA, ABE, ECE or TTG."},"approval_number":{"type":"string","description":"Approval number."},"kba_number":{"type":"string","description":"KBA number of the approval, when known."},"entries":{"type":"array","description":"Wheel geometries covered by the document.","items":{"type":"object","properties":{"pcd":{"type":"string","description":"Bolt pattern."},"center_bore_mm":{"type":"number","description":"Center bore in mm."},"et_mm":{"type":"number","description":"Offset (ET) in mm."},"width_inch":{"type":"number","description":"Rim width in inches."},"diameter_inch":{"type":"number","description":"Rim diameter in inches."},"approvals":{"type":"array","items":{"type":"object","required":["type","number"],"properties":{"type":{"type":"string","enum":["TTG","ECE","KBA","ABE"],"description":"Kind of approval number: TTG, ECE, KBA or ABE."},"number":{"type":"string","description":"Approval number."},"pages":{"type":"array","items":{"type":"integer"},"description":"Pages of the document where the number appears."},"status":{"type":"string","enum":["observed","ambiguous","unassigned"],"description":"How the number is assigned to this geometry: observed, ambiguous or unassigned."}}},"description":"Approval numbers for this geometry."}}}},"obligation_codes":{"type":"array","items":{"type":"string"},"description":"Codes of all conditions and notes in the document."},"fasteners":{"type":"array","description":"Bolts or nuts named by the document (code S01, S02 …).","items":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Code of the fastener in the document (S01, S02 …)."},"type":{"type":"string","description":"Bolt or nut, as in the document."},"thread":{"type":"string","description":"Thread, e.g. M14x1,5."},"seat":{"type":"string","description":"Seat shape (e.g. Kugel, Kegel)."},"seat_diameter_mm":{"type":"number","description":"Seat diameter in mm."},"seat_angle_deg":{"type":"number","description":"Seat angle in degrees (taper seat)."},"torque_nm":{"type":"number","description":"Tightening torque in Nm."},"shaft_length_mm":{"type":"number","description":"Shaft length in mm."},"shaft_length_status":{"type":"string","description":"Whether the shaft length is documented."},"row_status":{"type":"string","description":"complete when all values of this row are documented."},"missing_fields":{"type":"array","items":{"type":"string"},"description":"Fields that the document row does not state."}}}},"fastener_status":{"type":"string","description":"How completely the fasteners of the document could be read."},"url":{"type":["string","null"],"description":"Link to the PDF of the document; null when not available."}}},"CatalogWheel":{"type":"object","required":["wheel_code"],"properties":{"wheel_code":{"type":"string","description":"Wheel code (letters, digits, dashes and underscores)."},"brand":{"type":"string","description":"Wheel brand."},"model_name":{"type":"string","description":"Model name of the wheel."},"design":{"type":"string","description":"Design name, when known."},"classification":{"type":"object","description":"Catalog classification (finish, spoke style, winter suitability) for display and filtering; no technical approval."},"diameters_inch":{"type":"array","items":{"type":"number"},"description":"Diameters in inches the wheel is available in."},"vehicle_count":{"type":"integer","description":"Number of vehicles with an offer for this wheel."},"variant_count":{"type":"integer","description":"Number of technical variants (size, ET, bolt pattern)."},"color_count":{"type":"integer","description":"Number of colors with images. 0 without the wheel images module."},"document_count":{"type":"integer","description":"Number of approval documents."},"preview":{"type":"object","description":"Preview image. Only with the wheel images module (wheel_images); otherwise missing."},"updated_at":{"type":"string","description":"Last change of the catalog entry."}}},"CatalogWheelDetail":{"allOf":[{"$ref":"#/components/schemas/CatalogWheel"},{"type":"object","properties":{"description":{"type":"string","description":"Description text of the wheel, when available."},"showcase":{"type":"object","description":"Showcase images. Only with the wheel images module (wheel_images); otherwise missing."},"colors":{"type":"array","items":{"type":"object","required":["name","views"],"properties":{"name":{"type":"string","description":"Color name."},"classification":{"type":"object","description":"Classification of this color."},"views":{"type":"object","description":"Views (front, side_25, side_minus_25, closeup) with image links per size."},"views_transparent":{"type":"object","description":"Same views and sizes as views with a transparent background (cut out, no ground shadow); only when all views exist for this color."}}},"description":"Colors with images (all views per color). Empty without the wheel images module (wheel_images)."},"variants":{"type":"array","items":{"type":"object","properties":{"sku":{"type":"string","description":"Article number of the manufacturer, when known."},"size":{"type":"string","description":"Size as text, e.g. 8,5x19."},"width_inch":{"type":"number","description":"Rim width in inches."},"diameter_inch":{"type":"number","description":"Rim diameter in inches."},"et_mm":{"type":"number","description":"Offset (ET) in mm."},"pcd":{"type":"string","description":"Bolt pattern \"5x112\" (multi-drilled \"5x112/5x120\"). Absent when the bolt count is not documented for this wheel; then pcd_circle_mm carries the circle."},"pcd_circle_mm":{"type":"number","description":"Bolt circle in mm, only when pcd is absent because the bolt count is not documented."},"pcd_list":{"type":"array","items":{"type":"string"},"description":"Multi-drilled wheels only: documented bolt patterns (\"5x112\")."},"pcd_circles_mm":{"type":"array","items":{"type":"number"},"description":"Multi-drilled wheels only: every bolt circle in mm, also when the bolt count is not documented."},"center_bore_mm":{"type":"number","description":"Center bore in mm."},"color":{"type":"string","description":"Color of this variant."},"classification":{"type":"object","description":"Classification of this variant."}}},"description":"Technical variants of the wheel."},"documents":{"type":"array","items":{"type":"object","required":["document_id"],"properties":{"document_id":{"type":"string","description":"Document id (doc_…); details via /v2/documents/{document_id}."},"approval_type":{"type":"string","description":"Kind of approval, e.g. KBA."},"approval_number":{"type":"string","description":"Approval number."}}},"description":"Approval documents of the wheel."}}}]},"CatalogWheelListItem":{"allOf":[{"$ref":"#/components/schemas/CatalogWheel"},{"type":"object","properties":{"colors":{"type":"array","description":"Only with include=colors.","items":{"type":"object","required":["name","views"],"properties":{"name":{"type":"string","description":"Color name."},"classification":{"type":"object","description":"Classification of this color."},"views":{"type":"object","description":"Views with image links per size."},"views_transparent":{"type":"object","description":"Same views and sizes as views with a transparent background (cut out, no ground shadow); only when all views exist for this color."}}}}}}]},"BodyNotice":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["body_image_missing","body_differs","body_unconfirmed"]},"message":{"type":"string"}}},"ImageGroup":{"type":"object","required":["vehicle_image_id","label"],"properties":{"vehicle_image_id":{"type":"string"},"label":{"type":"string"},"brand":{"type":["string","null"]},"model":{"type":["string","null"]},"generation":{"type":["string","null"]},"body_type":{"type":["string","null"]},"years":{"type":"object","properties":{"from":{"type":["integer","null"]},"to":{"type":["integer","null"]}}},"body_match":{"type":"string","enum":["exact","unconfirmed","differs"],"description":"Only when matched by vehicle: exact body type, unconfirmed (body type of the vehicle not confirmed) or differs."},"body_notice":{"$ref":"#/components/schemas/BodyNotice"}}},"ImageRelease":{"type":"object","required":["wheel_code","revision","paints","finishes"],"properties":{"wheel_code":{"type":"string"},"revision":{"type":"string"},"release_type":{"type":"string"},"preferred_delivery":{"type":"string"},"delivery_modes":{"type":"array","items":{"type":"string"}},"paints":{"type":"array","items":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"label":{"type":"string"},"hex":{"type":"string"}}}},"finishes":{"type":"array","items":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"label":{"type":"string"},"catalog_color":{"type":"string","description":"Color name in the wheel catalog."},"skus":{"type":"array","items":{"type":"string"}},"orderable":{"type":"boolean"},"aliases":{"type":"array","items":{"type":"string"},"description":"Older finish ids that are still accepted."}}}},"views":{"type":"array","items":{"type":"string"}},"renditions":{"type":"array","items":{"type":"object"}},"wheel_sizes":{"type":"array","items":{"type":"integer"},"description":"With a vehicle: only the sizes approved for it."},"default_wheel_size":{"type":["integer","null"]},"base_finish":{"type":"string"},"finish_aliases":{"type":"object","additionalProperties":{"type":"string"},"description":"Older finish id → current finish id."}}},"ImageAvailability":{"type":"object","required":["available","ambiguous","matches","body_notice"],"properties":{"available":{"type":"boolean"},"ambiguous":{"type":"boolean"},"matches":{"type":"array","items":{"type":"object","required":["vehicle_image","matched_by","fitment_checked","wheels"],"properties":{"vehicle_image":{"$ref":"#/components/schemas/ImageGroup"},"matched_by":{"type":"string","enum":["vehicle_id","vehicle_image_id"]},"fitment_checked":{"type":"boolean"},"wheels":{"type":"array","items":{"$ref":"#/components/schemas/ImageRelease"}},"original_wheels":{"type":"object","description":"The vehicle with its original wheels in every paint (wheel_code original; no fitment check); renditions include the small sizes.","properties":{"wheel_code":{"type":"string","const":"original"},"paints":{"type":"array","items":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"label":{"type":"string"},"hex":{"type":"string"}}}},"views":{"type":"array","items":{"type":"string"}},"renditions":{"type":"array","items":{"type":"object"}}}}}}},"body_notice":{"$ref":"#/components/schemas/BodyNotice"}}},"ConfiguratorImages":{"type":"object","required":["vehicle_image","delivery","selection","revision","views"],"properties":{"vehicle_image":{"$ref":"#/components/schemas/ImageGroup"},"matched_by":{"type":"string","enum":["vehicle_id","vehicle_image_id"]},"fitment_checked":{"type":"boolean"},"delivery":{"type":"string","enum":["edge_render","layers","full_images"]},"render_order":{"type":"array","items":{"type":"string"}},"selection":{"type":"object","required":["wheel_code","paint","finish"],"properties":{"wheel_code":{"type":"string"},"paint":{"type":"string"},"finish":{"type":["string","null"],"description":"null for wheel_code original."},"size":{"type":["integer","null"]},"requested_finish":{"type":"string","description":"The older finish id sent, when it was mapped to finish."}}},"revision":{"type":"string"},"views":{"type":"object","description":"Per view and rendition: an image (url, expires_at, width, height) or, with delivery=layers, canvas, base and layers."}}},"MetaImages":{"type":"object","required":["api_version","data_version"],"properties":{"api_version":{"type":"integer"},"data_version":{"type":"string"},"urls_expire_at":{"type":["string","null"],"description":"Earliest expiry of the signed links in this response (ISO 8601)."}}},"VehicleImage":{"type":"object","required":["available","ambiguous","delivery_ready"],"description":"Only with include=vehicle_image.","properties":{"available":{"type":"boolean"},"ambiguous":{"type":"boolean"},"delivery_ready":{"type":"boolean"},"vehicle_image_id":{"type":["string","null"]},"label":{"type":["string","null"]},"thumbnail":{"type":["object","null"]},"body_match":{"type":["string","null"],"enum":["exact","unconfirmed","differs","missing",null]},"body_notice":{"$ref":"#/components/schemas/BodyNotice"},"matches":{"type":"array","items":{"type":"object"}}}}}},"x-error-codes":{"unknown_parameter":{"status":400,"description":"A query parameter is not supported by this endpoint."},"duplicate_parameter":{"status":400,"description":"A query parameter was sent more than once."},"invalid_path":{"status":400,"description":"The path contains an invalid percent-encoding."},"invalid_parameter":{"status":400,"description":"A parameter value is not valid."},"invalid_<parameter>":{"status":400,"description":"The named filter value is not valid (for example invalid_doors, invalid_min_power_kw, invalid_fuel)."},"invalid_query":{"status":400,"description":"A text filter is too short or too long (q: 2–100 characters, other text filters at most 100)."},"too_many_filters":{"status":400,"description":"Too many filter values in one request (at most 90)."},"too_many_wheel_codes":{"status":400,"description":"At most 50 wheel codes per request."},"invalid_limit":{"status":400,"description":"limit must be 1–100."},"invalid_cursor":{"status":400,"description":"The cursor is not valid or belongs to another request."},"invalid_include":{"status":400,"description":"An include value is not supported."},"invalid_view":{"status":400,"description":"view must be summary or full."},"invalid_sort":{"status":400,"description":"sort must be wheel_code or status."},"invalid_status":{"status":400,"description":"status must be a fitment status."},"invalid_vehicle_id":{"status":400,"description":"Vehicle ids are HSN-TSN, e.g. 0005-DFY."},"invalid_wheel_code":{"status":400,"description":"Wheel codes are letters, digits, dashes and underscores."},"invalid_document_id":{"status":400,"description":"Document ids look like doc_ followed by 24 hex characters."},"invalid_generation_id":{"status":400,"description":"Generation ids look like gen_ followed by 16 hex characters."},"invalid_brand_id":{"status":400,"description":"Brand ids are lowercase letters, digits and dashes."},"invalid_model_id":{"status":400,"description":"Model ids are lowercase letters, digits and dashes."},"invalid_engine_code":{"status":400,"description":"Engine codes are letters, digits and . / _ -."},"invalid_execution":{"status":400,"description":"This execution is not available for the generation."},"invalid_brand":{"status":400,"description":"brand must not be empty."},"invalid_model":{"status":400,"description":"model must not be empty."},"invalid_pcd":{"status":400,"description":"pcd must not be empty, e.g. 5x112."},"invalid_et":{"status":400,"description":"et_mm must be a number."},"invalid_diameter":{"status":400,"description":"diameter_inch must be a number."},"invalid_fuel":{"status":400,"description":"Unsupported fuel value."},"invalid_with_fitments":{"status":400,"description":"with_fitments must be 0 or 1."},"invalid_with_logo":{"status":400,"description":"with_logo must be 0 or 1."},"invalid_date":{"status":400,"description":"from/to must be calendar dates like 2026-10-01."},"invalid_date_range":{"status":400,"description":"from must not be after to; at most 92 days."},"invalid_axle":{"status":400,"description":"axle must be front or rear."},"invalid_product_code":{"status":400,"description":"product_code must not be empty."},"invalid_vsn":{"status":400,"description":"vsn must be the 5 characters of field 2.2 positions 4–8, optionally with the check digit."},"invalid_selection":{"status":400,"description":"The selection is not valid for this request."},"invalid_size":{"status":400,"description":"The image size is not available."},"invalid_delivery":{"status":400,"description":"The image delivery value is not supported."},"invalid_vehicle_image_id":{"status":400,"description":"Vehicle image ids look like img_ followed by hex characters."},"invalid_ids":{"status":400,"description":"ids must list 2–5 different vehicle ids (HSN-TSN), comma-separated."},"invalid_selections":{"status":400,"description":"selections must be <vehicle_id>:<selection_id> pairs, at most one per vehicle listed in ids."},"missing_filter":{"status":400,"description":"At least one filter is required."},"missing_brand":{"status":400,"description":"model_id needs brand."},"missing_selection":{"status":400,"description":"This request needs a selection."},"selection_not_for_vehicle":{"status":400,"description":"The selection does not belong to the vehicle."},"selection_not_supported":{"status":400,"description":"This endpoint does not support this kind of selection."},"variant_not_for_vehicle":{"status":400,"description":"The variant does not belong to the vehicle."},"configuration_not_for_vehicle":{"status":400,"description":"The configuration does not belong to the vehicle."},"configurator_vehicle_ambiguous":{"status":400,"description":"Several image groups match this vehicle; send vehicle_image_id."},"configurator_layers_unavailable":{"status":400,"description":"This image set has no layers; use delivery=render."},"unauthorized":{"status":401,"description":"Credentials are missing."},"invalid_credentials":{"status":401,"description":"API key or secret is not valid."},"subscription_inactive":{"status":403,"description":"The subscription for this API key is not active."},"feature_not_enabled":{"status":403,"description":"The add-on module is not enabled for this API key."},"route_not_found":{"status":404,"description":"Unknown route."},"vehicle_not_found":{"status":404,"description":"Vehicle not found."},"wheel_not_found":{"status":404,"description":"Wheel not found."},"document_not_found":{"status":404,"description":"Document not found."},"brand_not_found":{"status":404,"description":"Brand not found."},"model_not_found":{"status":404,"description":"Model not found for this brand."},"generation_not_found":{"status":404,"description":"Generation not found."},"configurator_not_found":{"status":404,"description":"No configurator images for this vehicle."},"configurator_selection_not_found":{"status":404,"description":"No configurator images for this selection."},"configurator_size_not_found":{"status":404,"description":"No configurator images in this size."},"configurator_body_image_missing":{"status":404,"description":"The body image is missing."},"configurator_wheel_not_published":{"status":404,"description":"No published images for this wheel."},"wheel_not_approved_for_vehicle":{"status":404,"description":"The wheel is not approved for this vehicle."},"wheel_size_not_approved_for_vehicle":{"status":404,"description":"The wheel size is not approved for this vehicle."},"method_not_allowed":{"status":405,"description":"Only GET (and OPTIONS) are supported."},"data_version_changed":{"status":409,"description":"The data release changed (cursor or data_version). Restart from the first page."},"quota_exceeded":{"status":429,"description":"The monthly request quota is used up (see Retry-After and X-RateLimit-Reset)."},"too_many_requests":{"status":429,"description":"Too many requests in a short time (100 per 10 seconds per key; see Retry-After)."},"internal_error":{"status":500,"description":"Unexpected error. Retry later; if it persists, contact support."},"data_unavailable":{"status":503,"description":"No data release is active."},"not_in_release":{"status":503,"description":"This endpoint is not available in the active data release."},"service_unavailable":{"status":503,"description":"A data store or usage counting is temporarily not available (see Retry-After)."},"usage_unavailable":{"status":503,"description":"The usage log is not available yet."},"configurator_edge_not_configured":{"status":503,"description":"The image service is not configured."},"configurator_asset_invalid":{"status":503,"description":"An image asset is not valid."}}}