{"version":1,"resources":["https://stableflowers.dev/api/products","https://stableflowers.dev/api/delivery-dates","https://stableflowers.dev/api/quote","https://stableflowers.dev/api/orders","https://stableflowers.dev/api/orders/{orderId}","https://stableflowers.dev/api/products/search"],"description":"Send florist-delivered flowers in the US and Canada through Florist One. Pay the exact Florist One order total with x402 on Base.","instructions":"# StableFlowers API\n\nStableFlowers sends real florist-delivered flowers through Florist One. Buyers pay the exact Florist One order total with x402 on Base. StableFlowers does not add a service fee.\n\nSupported payment: x402 on Base mainnet only.\n\nProduct browsing, delivery-date checks, quotes, and order lookups require SIWX. Order placement requires x402 payment.\n\n## Flow\n\n1. GET /api/products/search — search flower products by query with SIWX. Use this when a user describes an occasion like \"get well\", \"birthday\", or \"sympathy\".\n2. GET /api/products — browse flower products by category or product code with SIWX.\n3. GET /api/delivery-dates — list available delivery dates for a recipient ZIP/postal code with SIWX.\n4. POST /api/quote — calculate the exact Florist One total for flower products with SIWX.\n5. POST /api/orders — pay the quoted total with x402 and place the order.\n6. GET /api/orders/{orderId} — retrieve a stored order by local ID or Florist One order number with SIWX.\n\n## Important Behavior\n\nStableFlowers supports flower products only. Do not submit tree products with code TREES.\n\nProduct endpoints return normalized product cards with code, name, price, description, image, categories, and dimensions. Use the returned product code and price in quote/order calls.\n\nOrder pricing is dynamic and advertised as a $50-$300 range. Always call /api/quote before /api/orders, then submit the same products and delivery details to /api/orders. The paid order endpoint validates delivery availability and total before requesting payment, and the buyer pays the exact quoted Florist One total.\n\nPOST /api/orders requires buyer.name, buyer.email, buyer.phone, and recipient delivery details. Do not ask for sender/customer address details; StableFlowers supplies the sender address internally as Merit Systems, 300 Kent Ave, 604, Brooklyn, NY 11249. Recipient is the person and address receiving the flowers. Do not ask users for substitution preferences; StableFlowers always allows minor substitutions internally so local florists can fulfill the order.\n\nFlorist One handles customer service directly. Returned confirmations include their support contact:\n- Phone: 888-610-8262\n- Text: 501-406-0358\n- Email: service@floristone.com\n\nFlorist One does not expose live delivery tracking or cancellation through the API. The order lookup endpoint returns the submitted order details, not live delivery status.\n\n## Idempotency\n\nPOST /api/orders requires clientRequestId. Reuse the same clientRequestId only for retrying the same intended order. StableFlowers uses it to prevent duplicate Florist One order placement.\n\n## Refund Credits\n\nFlorist One reports full and partial credits through a daily report. StableFlowers records these credits for manual customer refund handling."}