{"openapi":"3.1.0","info":{"title":"Autoza UK Public API","description":"Public read-only API for searching vehicles, dealers, and market data on Autoza UK (autoza.co.uk). No authentication required for basic search.","version":"1.0.0","contact":{"name":"Autoza Support","email":"info@autoza.co.uk","url":"https://autoza.co.uk"}},"servers":[{"url":"https://autoza.co.uk","description":"Production"}],"paths":{"/api/v1/vehicles":{"get":{"summary":"Search vehicles","description":"Search all active vehicle listings on Autoza UK. Returns paginated results.","operationId":"searchVehicles","parameters":[{"name":"make","in":"query","schema":{"type":"string"},"description":"Vehicle make, e.g. Toyota"},{"name":"model","in":"query","schema":{"type":"string"},"description":"Vehicle model, e.g. Corolla"},{"name":"min_year","in":"query","schema":{"type":"integer"},"description":"Minimum year"},{"name":"max_year","in":"query","schema":{"type":"integer"},"description":"Maximum year"},{"name":"min_price","in":"query","schema":{"type":"number"},"description":"Minimum price (GBP)"},{"name":"max_price","in":"query","schema":{"type":"number"},"description":"Maximum price (GBP)"},{"name":"fuel_type","in":"query","schema":{"type":"string","enum":["petrol","diesel","electric","hybrid"]},"description":"Fuel type"},{"name":"transmission","in":"query","schema":{"type":"string","enum":["manual","automatic"]},"description":"Transmission type"},{"name":"body_type","in":"query","schema":{"type":"string","enum":["suv","hatchback","saloon","van","estate","coupe"]},"description":"Body type"},{"name":"location","in":"query","schema":{"type":"string"},"description":"County or city, e.g. Dublin"},{"name":"page","in":"query","schema":{"type":"integer","default":1},"description":"Page number"},{"name":"limit","in":"query","schema":{"type":"integer","default":20,"maximum":50},"description":"Results per page (max 50)"}],"responses":{"200":{"description":"Successful search","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/VehicleSummary"}},"meta":{"$ref":"#/components/schemas/PaginationMeta"}}}}}}}}},"/api/v1/vehicles/{id}":{"get":{"summary":"Get vehicle details","description":"Get full details of a specific vehicle listing including dealer info and images.","operationId":"getVehicle","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Vehicle listing ID"}],"responses":{"200":{"description":"Vehicle details"},"404":{"description":"Vehicle not found"}}}},"/api/v1/dealers":{"get":{"summary":"Search dealers","description":"Search for car dealers across Ireland.","operationId":"searchDealers","parameters":[{"name":"location","in":"query","schema":{"type":"string"},"description":"City or county"},{"name":"page","in":"query","schema":{"type":"integer","default":1}},{"name":"limit","in":"query","schema":{"type":"integer","default":20,"maximum":50}}],"responses":{"200":{"description":"Dealer list"}}}},"/api/v1/dealers/{id}":{"get":{"summary":"Get dealer profile","description":"Get dealer profile details including inventory count.","operationId":"getDealer","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Dealer profile"},"404":{"description":"Dealer not found"}}}},"/api/v1/market/ireland":{"get":{"summary":"Irish market summary","description":"Current Irish used car market data: average prices, most listed makes, listing counts.","operationId":"getMarketSummary","responses":{"200":{"description":"Market summary data"}}}}},"components":{"schemas":{"VehicleSummary":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string","format":"uri"},"make":{"type":"string"},"model":{"type":"string"},"year":{"type":"integer"},"price":{"type":"number"},"currency":{"type":"string","example":"GBP"},"mileage":{"type":"integer"},"fuel_type":{"type":"string"},"transmission":{"type":"string"},"body_type":{"type":"string"},"location":{"type":"string"},"images":{"type":"array","items":{"type":"string","format":"uri"}}}},"PaginationMeta":{"type":"object","properties":{"total":{"type":"integer"},"page":{"type":"integer"},"limit":{"type":"integer"},"pages":{"type":"integer"},"generated_at":{"type":"string","format":"date-time"},"source":{"type":"string","example":"Autoza UK — autoza.co.uk"}}}}}}