{"openapi":"3.1.0","info":{"title":"Lina Flowers Agent Catalog API","version":"2026-07-18","description":"Read-only public product, occasion, and delivery facts for Lina Flowers. Final product and delivery availability must be confirmed at order time."},"servers":[{"url":"https://linaflower.com"}],"paths":{"/api/agent/v1/catalog":{"get":{"operationId":"searchLinaFlowersCatalog","summary":"Search the current flower catalog","parameters":[{"name":"q","in":"query","schema":{"type":"string","maxLength":120}},{"name":"occasion","in":"query","schema":{"type":"string"}},{"name":"category","in":"query","schema":{"type":"string"}},{"name":"max_price","in":"query","schema":{"type":"number","minimum":0}},{"name":"same_day","in":"query","schema":{"type":"boolean"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50}}],"responses":{"200":{"description":"Catalog search results"}}}},"/api/agent/v1/products/{slug}":{"get":{"operationId":"getLinaFlowersProduct","summary":"Get one product by canonical slug","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Product facts"},"404":{"description":"Product not found"}}}},"/api/agent/v1/occasions":{"get":{"operationId":"listLinaFlowersOccasions","summary":"List occasion and seasonal flower guides","responses":{"200":{"description":"Occasion guide list"}}}},"/api/agent/v1/delivery":{"get":{"operationId":"checkLinaFlowersDelivery","summary":"Check delivery-zone and requested-date eligibility","parameters":[{"name":"city","in":"query","schema":{"type":"string"}},{"name":"postal_code","in":"query","schema":{"type":"string","pattern":"^[0-9]{5}$"}},{"name":"requested_date","in":"query","schema":{"type":"string","format":"date"}}],"responses":{"200":{"description":"Delivery eligibility guidance"}}}}}}