{"openapi":"3.1.0","info":{"title":"Sagar Collection Kids Wear Storefront API","version":"1.0.0","description":"Public read-only API for AI shopping assistants, search engines, and agents to discover kids wear products, live variant stock, categories, and store fulfillment settings at Sagar Collection."},"servers":[{"url":"https://sagarcollection.in"}],"paths":{"/api/v1/products":{"get":{"operationId":"listProducts","summary":"Search and filter kids wear products with pagination","parameters":[{"name":"page","in":"query","schema":{"type":"integer","default":1}},{"name":"limit","in":"query","schema":{"type":"integer","default":16}},{"name":"category","in":"query","schema":{"type":"string"},"description":"e.g. Baba Suits, Party Frocks, Ethnic Kurta Sets, Newborn Rompers"},{"name":"ageGroup","in":"query","schema":{"type":"string"},"description":"e.g. 0-12M, 1-3Y, 4-7Y, 8-12Y"},{"name":"search","in":"query","schema":{"type":"string"},"description":"Keyword search by title, fabric, category, or SKU"},{"name":"maxPrice","in":"query","schema":{"type":"number"},"description":"Maximum price in INR"},{"name":"inStockOnly","in":"query","schema":{"type":"boolean"}},{"name":"sortBy","in":"query","schema":{"type":"string","enum":["popularity","price_low","price_high","discount","newest"]}}],"responses":{"200":{"description":"Paginated product list with category counts"}}}},"/api/v1/products/{sku}":{"get":{"operationId":"getProductBySku","summary":"Get single kids wear product details and live color/size variant inventory by SKU","parameters":[{"name":"sku","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Product details with variant inventory"}}}},"/api/v1/categories":{"get":{"operationId":"listCategories","summary":"List active kids wear categories","responses":{"200":{"description":"List of store categories"}}}},"/api/v1/settings":{"get":{"operationId":"getStoreSettings","summary":"Get store location, operating hours, WhatsApp contact, pickup & delivery rules","responses":{"200":{"description":"Store settings and fulfillment policies"}}}}}}