{"openapi":"3.1.0","info":{"title":"Mandi Rate Public API","version":"1.0.0","description":"Automated API for daily vegetable rates across Pakistan markets (Lahore, Karachi, Rawalpindi, Islamabad, Faisalabad)."},"servers":[{"url":"https://mandirate.com","description":"Production Server"}],"paths":{"/api/rates":{"get":{"summary":"Get current daily vegetable rates","operationId":"getVegetableRates","parameters":[{"name":"city","in":"query","required":false,"schema":{"type":"string"},"description":"Filter rates by city name (e.g. 'Lahore')"},{"name":"category","in":"query","required":false,"schema":{"type":"string"},"description":"Filter by category ('Daily Essentials', 'Green Veggies', etc.)"}],"responses":{"200":{"description":"List of vegetable rates and stock status","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"timestamp":{"type":"string"},"mandi":{"type":"string"},"rates":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"urduName":{"type":"string"},"category":{"type":"string"},"ratePerKg":{"type":"number"},"ratePer5Kg":{"type":"number"},"ratePerMann":{"type":"number"},"inStock":{"type":"boolean"}}}}}}}}}}}},"/api/health":{"get":{"summary":"Check API and database health status","operationId":"getHealthStatus","responses":{"200":{"description":"System health check response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string"},"uptime":{"type":"number"},"timestamp":{"type":"string"}}}}}}}}}}}