FINN Auto - Car Subscription

{'type': 'object', 'properties': {}, 'additionalProperties': False}

{'type': 'object', 'required': ['brand'], 'properties': {'brand': {'type': 'string', 'maxLength': 100, 'minLength': 1, 'description': 'Brand name (e.g. "Ford", "Mercedes-Benz", "BMW")'}, 'model': {'type': 'string', 'maxLength': 100, 'minLength': 1, 'description': 'Optional model name (e.g. "Puma", "iX1"). If omitted, returns all available models for the brand.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['vehicle_id', 'term_months', 'km_package'], 'properties': {'km_package': {'description': 'Monthly km package (500, 1000, 1500, 2000, 2500, 3000, 4000, 5000)'}, 'vehicle_id': {'type': 'string', 'pattern': '^[a-zA-Z0-9-]+$', 'maxLength': 200, 'description': 'The vehicle product ID'}, 'term_months': {'description': 'Subscription term in months (1, 6, 9, 12, 13, 18, 24, 36)'}, 'down_payment_amount': {'type': 'number', 'minimum': 0, 'description': 'Optional one-time Fahrzeugbereitstellung (vehicle provisioning fee) in EUR, paid upfront as Einmalzahlung. When provided, the checkout URL gets `?downPaymentAmount={amount}` and the monthly price drops accordingly. When omitted, the fee is spread across the term inside the monthly price.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['vehicle_id'], 'properties': {'vehicle_id': {'type': 'string', 'pattern': '^[a-zA-Z0-9-]+$', 'maxLength': 200, 'description': 'The vehicle product ID (e.g. "bmw-ix1-12345-alpinweissuni")'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'sort': {'enum': ['asc', 'desc', 'availability', 'last_added'], 'type': 'string', 'description': 'Sort order: asc/desc by price, availability, or last_added'}, 'fuels': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Fuel types in German (e.g. ["Elektro", "Benzin", "Diesel", "Plug-In-Hybrid"])'}, 'limit': {'type': 'number', 'maximum': 10, 'minimum': 1, 'description': 'Number of results (1-10, default 5)'}, 'terms': {'type': 'array', 'items': {'type': 'number'}, 'description': 'Subscription term lengths in months (available: 1, 6, 12, 18, 24, 36)'}, 'brands': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Car brands (e.g. ["BMW", "Audi", "Mercedes-Benz"])'}, 'colors': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Colors in German (e.g. ["Schwarz", "Weiß", "Blau"])'}, 'models': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Car models (e.g. ["iX1", "3er Limousine"])'}, 'cartypes': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Car types in German (e.g. ["SUV", "Kombi", "Kleinwagen", "Van"])'}, 'has_deals': {'type': 'boolean', 'description': 'Filter for cars with special deals/discounts'}, 'has_hitch': {'type': 'boolean', 'description': 'Filter for cars with hitch'}, 'max_power': {'type': 'number', 'description': 'Maximum power in kW'}, 'max_price': {'type': 'number', 'description': 'Maximum monthly price in EUR'}, 'min_power': {'type': 'number', 'description': 'Minimum power in kW'}, 'min_price': {'type': 'number', 'description': 'Minimum monthly price in EUR'}, 'available_to': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Latest delivery date (YYYY-MM-DD)'}, 'max_ev_range': {'type': 'number', 'description': 'Maximum electric range in km'}, 'min_ev_range': {'type': 'number', 'description': 'Minimum electric range in km'}, 'available_from': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Earliest delivery date (YYYY-MM-DD)'}, 'is_young_driver': {'type': 'boolean', 'description': 'Filter for cars allowing drivers under 23'}}, 'additionalProperties': False}