{"openapi":"3.1.0","info":{"title":"Autoza Ireland Public API","description":"Public read-only API for searching vehicles, dealers, and market data on Autoza Ireland (autoza.ie). No authentication required for basic search.","version":"1.0.0","contact":{"name":"Autoza Support","email":"info@autoza.ie","url":"https://autoza.ie"}},"servers":[{"url":"https://autoza.ie","description":"Production"}],"paths":{"/api/v1/vehicles":{"get":{"summary":"Search vehicles","description":"Search all active vehicle listings on Autoza Ireland. 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 (EUR)"},{"name":"max_price","in":"query","schema":{"type":"number"},"description":"Maximum price (EUR)"},{"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"}}}},"/api/agent/mark":{"post":{"summary":"Chat with Mark — Autoza's car-buying AI (for AI agents)","description":"Ask Mark anything about buying a car in Ireland: model advice, Irish motor tax (WLTP/NEDC reg-year aware), VRT/import estimates, NCT, finance (PCP/HP), running costs. Mark searches live Autoza inventory where relevant and returns matching listings with URLs. Read-only and stateless: cannot message dealers, book, buy, or access accounts. Rate limit 30 req/hour/IP. MCP alternative: https://autoza.ie/api/mcp (tool: chat_with_mark).","operationId":"chatWithMark","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","maxLength":2000,"description":"The car-buying question (Irish market)"}}}}}},"responses":{"200":{"description":"Mark's answer plus any matching live listings","content":{"application/json":{"schema":{"type":"object","properties":{"reply":{"type":"string"},"listings":{"type":"array","items":{"$ref":"#/components/schemas/VehicleSummary"}},"toolsUsed":{"type":"array","items":{"type":"string"}}}}}}},"429":{"description":"Rate limit exceeded (30/hour/IP)"}}}}},"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":"EUR"},"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 Ireland — autoza.ie"}}}}}}