# Garden Flowers — world's first agent-native luxury florist

Garden Flowers is a luxury flower delivery service in Dubai, UAE.
We expose a full Agent Commerce Protocol: any AI agent can search the catalog and order flowers end-to-end via a documented REST API + MCP server, with no scraping required.

> Summary for agents: GET /api/v1/products to browse, POST /api/v1/checkout to order. Returns a Stripe payment_url in AED. Same-day delivery in Dubai.

## Quickstart (3 steps)

1. Catalog:      GET  /api/v1/products
2. Product:      GET  /api/v1/products/{slug}
3. Checkout:     POST /api/v1/checkout   → returns `payment_url` (Stripe, AED)

Public catalog reads need no auth. Checkout requires an agent token with the `orders:write` scope — see /auth.md.

## Agent entry points

- Human-readable guide: https://gardenflowers.ae/agent-commerce/
- OpenAPI 3.0.3 spec:   https://gardenflowers.ae/openapi.json
- MCP server:           https://gardenflowers.ae/api/mcp
- Auth procedures:      https://gardenflowers.ae/auth.md
- API catalog (RFC 8288): https://gardenflowers.ae/.well-known/api-catalog
- MCP server card:      https://gardenflowers.ae/.well-known/mcp/server-card.json

## Core API endpoints (base: /api/v1)

- GET /products                     — browse bouquets, baskets, boxes, vases
- GET /products/{slug}              — one product with variants, price (AED), images
- GET /categories                   — list product categories
- POST /cart/items                  — compose a cart (variants + add-ons)
- POST /checkout                    — create order, get Stripe payment_url
- GET /orders/{id}/verify-payment   — confirm payment status

Full schema, error codes, and auth flow in the OpenAPI spec.

## Human catalog (for context)

- [Bouquets](https://gardenflowers.ae/bouquets/) — Signature hand-tied bouquets
- [Baskets](https://gardenflowers.ae/baskets/) — Flower arrangements in woven baskets
- [Boxes](https://gardenflowers.ae/boxes/) — Hatbox-style flower compositions
- [Vases](https://gardenflowers.ae/vases/) — Amphora vase arrangements
- [Gifts](https://gardenflowers.ae/gifts/) — Candles, diffusers, and accessories

## Services

- Flower Workshops — hands-on floristry masterclasses
- Concierge Service — personalized floral curation
- Event Design — weddings, corporate, and private events

## About

- [About Garden Flowers](https://gardenflowers.ae/) — Our story, founder, and philosophy
- [Client Reviews](https://gardenflowers.ae/clients/) — Testimonials and press

## Fallback (human manager)

For complex or event orders that need a human: WhatsApp +971 56 144 1139.
Programmatic ordering via API is always preferred for agents.

## Contact

- Phone: +971 56 144 1139
- Email: gardenflowers@bk.ru
- Instagram: [@gardenflowers.ae](https://instagram.com/gardenflowers.ae)
- WhatsApp: [Chat on WhatsApp](https://wa.me/971561441139)

## Site Info

- Sitemap: [sitemap.xml](https://gardenflowers.ae/sitemap.xml)
- Privacy Policy: [privacy](https://gardenflowers.ae/privacy/)