{"openapi":"3.1.0","info":{"title":"Celebrate Festival Inc API","version":"1.0.0","description":"Public API surface for the Celebrate Festival Inc B2B restaurant equipment storefront. Covers product discovery, catalog browsing, search, and cart management.","contact":{"name":"Hiraya Digital","email":"dev@hiraya.digital","url":"https://hiraya.digital"},"x-logo":{"url":"https://celebratefestivalinc.com/cdn/shop/files/logo.png"}},"servers":[{"url":"https://celebratefestivalinc.com","description":"Shopify Storefront (production)"}],"tags":[{"name":"Products","description":"Restaurant and kitchen equipment products"},{"name":"Collections","description":"Equipment categories"},{"name":"Search","description":"Full-text product search"},{"name":"Cart","description":"Shopping cart management"}],"paths":{"/search":{"get":{"tags":["Search"],"summary":"Search products","operationId":"searchProducts","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"},"description":"Search query"},{"name":"sort_by","in":"query","schema":{"type":"string","enum":["best-selling","price-ascending","price-descending","title-ascending","title-descending"]}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1}}],"responses":{"200":{"description":"Search results page"}}}},"/search.json":{"get":{"tags":["Search"],"summary":"Search products JSON","operationId":"searchProductsJson","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"}},{"name":"resources[type]","in":"query","schema":{"type":"string","default":"product,collection"}},{"name":"limit","in":"query","schema":{"type":"integer","default":10,"maximum":10}}],"responses":{"200":{"description":"JSON search results","content":{"application/json":{"schema":{"type":"object","properties":{"results":{"type":"object","properties":{"products":{"type":"array","items":{"$ref":"#/components/schemas/Product"}}}}}}}}}}}},"/{handle}.js":{"get":{"tags":["Products"],"summary":"Product JSON","operationId":"getProductJson","parameters":[{"name":"handle","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Product JSON","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Product"}}}}}}},"/cart.js":{"get":{"tags":["Cart"],"summary":"Get cart","operationId":"getCart","responses":{"200":{"description":"Cart JSON"}}}},"/cart/add.js":{"post":{"tags":["Cart"],"summary":"Add to cart","operationId":"addToCart","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["id","quantity"],"properties":{"id":{"type":"integer","description":"Variant ID"},"quantity":{"type":"integer","minimum":1}}}}}},"responses":{"200":{"description":"Updated cart"},"422":{"description":"Item unavailable"}}}}},"components":{"schemas":{"Product":{"type":"object","properties":{"id":{"type":"integer"},"title":{"type":"string"},"handle":{"type":"string"},"vendor":{"type":"string"},"product_type":{"type":"string"},"available":{"type":"boolean"},"price":{"type":"integer","description":"Price in cents"},"compare_at_price":{"type":"integer","nullable":true},"variants":{"type":"array","items":{"$ref":"#/components/schemas/Variant"}}}},"Variant":{"type":"object","properties":{"id":{"type":"integer"},"title":{"type":"string"},"sku":{"type":"string"},"price":{"type":"integer"},"available":{"type":"boolean"}}}}},"x-ai-agent-hints":{"primary_use_case":"B2B restaurant equipment discovery and purchasing","public_endpoints":["/search","/search.json","/collections/*","/products/*.js","/cart.js"],"sitemap":"https://celebratefestivalinc.com/sitemap.xml","catalog":"https://celebratefestivalinc.com/pages/api-catalog","agent_skills":"https://celebratefestivalinc.com/pages/agent-skills"}}