{"openapi":"3.1.0","info":{"title":"Migos HVAC API","version":"1.0.0","description":"REST API documentation for the Migos HVAC admin and storefront."},"servers":[{"url":"/"}],"tags":[{"name":"Estimates"},{"name":"Products"},{"name":"Customers"},{"name":"Sales"},{"name":"Invoices"},{"name":"Credit Notes"},{"name":"Inventory"},{"name":"Marketing"},{"name":"Users"},{"name":"Uploads"}],"paths":{"/api/estimates":{"get":{"tags":["Estimates"],"summary":"List estimates","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Estimate"}}}}}}},"post":{"tags":["Estimates"],"summary":"Create estimate","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EstimateCreate"}}}},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Estimate"}}}}}}},"/api/estimates/{id}":{"get":{"tags":["Estimates"],"summary":"Get estimate by id","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Estimate"}}}},"404":{"description":"Not found"}}},"patch":{"tags":["Estimates"],"summary":"Update estimate","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EstimatePartial"}}}},"responses":{"200":{"description":"Updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Estimate"}}}},"404":{"description":"Not found"}}}},"/api/estimates/{id}/pdf":{"get":{"tags":["Estimates"],"summary":"Get estimate PDF","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"PDF","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"404":{"description":"Not found"}}}},"/api/products":{"get":{"tags":["Products"],"summary":"List published products by category/subcategory","parameters":[{"in":"query","name":"cat","required":false,"schema":{"type":"string","description":"Mongo ObjectId"}},{"in":"query","name":"sub","required":false,"schema":{"type":"string","description":"Mongo ObjectId"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"products":{"type":"array","items":{"$ref":"#/components/schemas/Product"}},"total":{"type":"number"}}}}}},"400":{"description":"Missing filters"}}}},"/api/admin/products/search":{"get":{"tags":["Products"],"summary":"Search products (admin)","parameters":[{"in":"query","name":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"products":{"type":"array","items":{"$ref":"#/components/schemas/Product"}}}}}}}}}}},"components":{"schemas":{"EstimateItem":{"type":"object","properties":{"id":{"type":"string"},"description":{"type":"string"},"quantity":{"type":"number"},"unitPrice":{"type":"number"},"taxRate":{"type":"number","description":"e.g. 0.13 = 13%"}},"required":["id","description","quantity","unitPrice"]},"Estimate":{"type":"object","properties":{"id":{"type":"string"},"number":{"type":"string"},"date":{"type":"string","format":"date-time"},"validUntil":{"type":"string","format":"date-time"},"customer":{"type":"object","properties":{"name":{"type":"string"},"email":{"type":"string"},"address":{"type":"string"},"customerId":{"type":"string"}},"required":["name"]},"items":{"type":"array","items":{"$ref":"#/components/schemas/EstimateItem"}},"notes":{"type":"string"},"currency":{"type":"string","enum":["USD"]},"status":{"type":"string","enum":["draft","sent","accepted","declined"]}},"required":["id","number","date","customer","items"]},"EstimateCreate":{"type":"object","properties":{"customer":{"$ref":"#/components/schemas/Estimate/properties/customer"},"items":{"type":"array","items":{"$ref":"#/components/schemas/EstimateItem"}},"notes":{"type":"string"},"status":{"type":"string","enum":["draft","sent","accepted","declined"]},"validUntil":{"type":"string","format":"date-time"}},"required":["customer","items"]},"EstimatePartial":{"type":"object","description":"Any subset of Estimate fields to update"},"Product":{"type":"object","properties":{"_id":{"type":"string"},"name":{"type":"string"},"sku":{"type":"string"},"price":{"type":"number"},"salePrice":{"type":"number"},"taxRate":{"type":"number"}},"required":["_id","name"]}}}}