flowers

Find flower arrangements in The Flowers Directory catalog by occasion, color, flower type, budget and free text. Every result includes the product code needed by check_delivery and get_checkout_link, the arrangement price, and total_before_tax (price plus the flat $19.99 delivery fee). Returns up to 20 matches, best match first.

{
  "type": "object",
  "properties": {
    "occasion": {
      "type": "string",
      "description": "One of: sympathy, birthday, romance, anniversary, get_well, new_baby, thank_you, mothers_day, congratulations, wedding, just_because. \"funeral\" is accepted as sympathy."
    },
    "colors": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Colors that should appear in the arrangement (any match). Known values: red, pink, white, yellow, purple, lavender, orange, blue, green, cream, peach, coral, burgundy, gold, mixed."
    },
    "flower_types": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Flower types that should appear (any match). Known values: roses, lilies, tulips, sunflowers, orchids, carnations, daisies, hydrangeas, alstroemeria, chrysanthemums, gerberas, lisianthus, snapdragons, dahlias, peonies, irises, delphinium, larkspur, gladiolus, calla lilies, freesia, ranunculus, asters, proteas, anthuriums, succulents, plants, mixed."
    },
    "budget": {
      "type": "number",
      "description": "Maximum all-in amount in USD before tax (arrangement price + $19.99 delivery). Use this for \"around $110\"-style requests."
    },
    "min_price": {
      "type": "number",
      "description": "Minimum arrangement price in USD."
    },
    "query": {
      "type": "string",
      "description": "Free-text keywords matched against the title and description, e.g. \"blue hydrangea in a vase\"."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "default": 8
    }
  },
  "additionalProperties": false
}

Check whether florist delivery is available to a US ZIP code on a given date. Availability is per ZIP and date, not per arrangement. Same-day delivery requires ordering before 2:00 PM in the recipient's local time zone.

{
  "type": "object",
  "properties": {
    "zip": {
      "type": "string",
      "pattern": "^\\d{5}$",
      "description": "Recipient 5-digit US ZIP code."
    },
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Requested delivery date, YYYY-MM-DD, in the recipient's local date."
    }
  },
  "required": [
    "zip",
    "date"
  ],
  "additionalProperties": false
}

Return the purchase link for an arrangement plus a price breakdown. With a recipient ZIP the breakdown includes the exact delivery fee, tax and order total; with a ZIP and date it also confirms delivery availability. Opening the link adds the arrangement to the cart and opens the cart panel; the customer clicks Checkout and enters the recipient address, delivery date, card message and payment there.

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "description": "Product code from search_arrangements, e.g. T163-1A."
    },
    "zip": {
      "type": "string",
      "pattern": "^\\d{5}$",
      "description": "Recipient ZIP code, for an exact total including tax."
    },
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Requested delivery date, YYYY-MM-DD. Requires zip."
    },
    "client": {
      "type": "string",
      "description": "Name of the assistant or app making the request (used only for attribution, e.g. \"chatgpt\")."
    }
  },
  "required": [
    "code"
  ],
  "additionalProperties": false
}