Autoza UK

{'type': 'object', 'properties': {'listing_id': {'type': 'string', 'description': 'The listing id, if you have it instead of the URL.'}, 'listing_url': {'type': 'string', 'description': 'The autoza.co.uk/listing/... URL returned by search_used_cars.'}, 'include_unanswered': {'type': 'boolean', 'description': 'Default true. Keep the questions we cannot answer in the response so the buyer can be told what is unknown.'}}}

{'type': 'object', 'required': ['registration_year', 'fuel'], 'properties': {'co2': {'type': 'number', 'description': 'CO2 emissions in g/km, from the V5C. Required for cars first registered 1 March 2001 – 31 March 2017. For cars registered from 1 April 2017 it only sets the one-off first-year rate. Ignored for pre-2001 cars.'}, 'fuel': {'enum': ['petrol', 'diesel', 'diesel-rde2', 'alternative', 'electric'], 'type': 'string', 'description': 'Fuel type. Use "alternative" for hybrid/LPG, "diesel-rde2" only for diesels meeting RDE2.'}, 'engine_size_cc': {'type': 'number', 'description': 'Engine size in cc. Required for cars first registered before 1 March 2001; not used otherwise.'}, 'registration_date': {'type': 'string', 'description': 'Full date of FIRST registration as YYYY-MM-DD, from the V5C. Optional but preferred: every UK VED boundary is a date (1 March 2001, 1 April 2017, 1 April 2025), so the year alone cannot tell a zero-emission car registered 1 March 2025 (no Expensive Car Supplement) from one registered 1 April 2025 (supplement). Without it, an ambiguous case is answered with a caveat in notes rather than a figure.'}, 'registration_year': {'type': 'integer', 'description': 'Year the car was FIRST registered (not the year it was bought). This decides which tax system applies.'}, 'list_price_when_new': {'type': 'number', 'description': 'Original list price in GBP when the car was new. Needed only to work out the Expensive Car Supplement — based on the price when NEW, not what you pay for it used.'}}}

{'type': 'object', 'required': ['fuel'], 'properties': {'fuel': {'enum': ['petrol', 'diesel', 'electric', 'hybrid'], 'type': 'string', 'description': 'Fuel type.'}, 'days_per_year': {'type': 'integer', 'description': 'Days per year the driver would enter a charging zone, 0–366. Defaults to 250 (a daily commute).'}, 'registration_year': {'type': 'integer', 'description': 'Year the car was first registered. Required unless fuel is "electric".'}}}

{'type': 'object', 'properties': {'mot_expires': {'type': 'string', 'description': 'Date the current MOT expires, ISO format YYYY-MM-DD. Use this for a car that already has an MOT.'}, 'first_registered': {'type': 'string', 'description': 'Date the car was first registered, ISO format YYYY-MM-DD. Use this for a car that has never had an MOT.'}}}

{'type': 'object', 'properties': {'listing_id': {'type': 'string', 'description': 'Listing id, if you have it instead of the URL.'}, 'listing_url': {'type': 'string', 'description': 'Full autoza.co.uk listing URL as returned by search_used_cars.'}}}

{'type': 'object', 'properties': {'model_slug': {'type': 'string', 'description': 'Model identifier, e.g. "ford-focus-common-faults-uk". Call with no argument to list every available model.'}}}

{'type': 'object', 'properties': {'make': {'type': 'string', 'description': 'Optional: narrow to a manufacturer.'}, 'model': {'type': 'string', 'description': 'Optional: narrow to a model.'}, 'vehicle_type': {'enum': ['car', 'van', 'motorcycle', 'motorhome', 'truck', 'caravan'], 'type': 'string', 'description': 'Vehicle type. Defaults to "car". Results are filtered on the vehicle type each listing is recorded under. Pass "van", "motorcycle", "motorhome", "truck" or "caravan" for other stock.'}}}

{'type': 'object', 'required': ['mileage'], 'properties': {'make': {'type': 'string', 'description': 'Manufacturer, e.g. "Ford". Optional, but needed (with model) for the model-level comparison.'}, 'model': {'type': 'string', 'description': 'Model, e.g. "Focus". Optional; see make.'}, 'mileage': {'type': 'integer', 'description': 'Current odometer reading in miles.'}, 'age_years': {'type': 'integer', 'description': 'Age in whole years, only if the registration year is not known.'}, 'registration_year': {'type': 'integer', 'description': 'Year the car was FIRST registered (V5C), e.g. 2016. Age is counted from it the way the DVSA figures were. Preferred over age_years.'}}}

{'type': 'object', 'properties': {'make': {'type': 'string', 'description': 'Manufacturer, e.g. "BMW", "Ford".'}, 'limit': {'type': 'integer', 'description': 'Max results, 1–25. Defaults to 10.'}, 'model': {'type': 'string', 'description': 'Model name, e.g. "Focus", "3 Series".'}, 'location': {'type': 'string', 'description': 'UK city or region, e.g. "Manchester", "Belfast".'}, 'max_year': {'type': 'integer'}, 'min_year': {'type': 'integer'}, 'body_type': {'type': 'string', 'description': 'e.g. "hatchback", "estate", "suv", "saloon".'}, 'fuel_type': {'type': 'string', 'description': 'e.g. "petrol", "diesel", "electric", "hybrid".'}, 'max_price': {'type': 'number', 'description': 'Maximum price in GBP.'}, 'min_price': {'type': 'number', 'description': 'Minimum price in GBP.'}, 'transmission': {'type': 'string', 'description': 'e.g. "manual", "automatic".'}, 'vehicle_type': {'enum': ['car', 'van', 'motorcycle', 'motorhome', 'truck', 'caravan'], 'type': 'string', 'description': 'Vehicle type. Defaults to "car". Results are filtered on the vehicle type each listing is recorded under. Pass "van", "motorcycle", "motorhome", "truck" or "caravan" for other stock.'}}}