NB8 Floral

Search NB8 Floral's artificial (silk) flower catalog by flower type, color and keywords. Returns matching products with price per pack, stems per pack, price per stem, delivery time, free-shipping flag, product link and photo. When nothing matching is listed on the website, returns pre-order options (estimated price, lead time on request). When the flower type is not recognized, returns the list of flower types in the catalog.

{
  "type": "object",
  "properties": {
    "flower_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Flower or greenery type in English, e.g. 'peony', 'rose', 'hydrangea', 'eucalyptus', 'babys breath'. Empty means keyword-only search.",
      "title": "Flower Type"
    },
    "color": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Color, e.g. 'white', 'blush pink', 'burgundy', 'sage green'.",
      "title": "Color"
    },
    "query": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Extra keywords matched against product names, e.g. 'sample box', 'bouquet', 'real touch'.",
      "title": "Query"
    },
    "us_stock_only": {
      "default": false,
      "description": "Only return items in the US warehouse (about 7-day delivery).",
      "title": "Us Stock Only",
      "type": "boolean"
    },
    "limit": {
      "default": 5,
      "description": "How many products to return (1-10).",
      "maximum": 10,
      "minimum": 1,
      "title": "Limit",
      "type": "integer"
    }
  },
  "title": "search_productsArguments"
}

{
  "type": "object",
  "additionalProperties": true,
  "title": "search_productsDictOutput"
}

Get today's price, pack size, stock and delivery time for specific NB8 Floral products by slug, optionally in a given color.

{
  "type": "object",
  "properties": {
    "items": {
      "description": "Products to look up.",
      "items": {
        "$ref": "#/$defs/ProductRef"
      },
      "maxItems": 20,
      "minItems": 1,
      "title": "Items",
      "type": "array"
    }
  },
  "required": [
    "items"
  ],
  "$defs": {
    "ProductRef": {
      "properties": {
        "slug": {
          "description": "Product slug, as returned in search or identification results.",
          "title": "Slug",
          "type": "string"
        },
        "color": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Color wanted, e.g. 'white'.",
          "title": "Color"
        }
      },
      "required": [
        "slug"
      ],
      "title": "ProductRef",
      "type": "object"
    }
  },
  "title": "get_productsArguments"
}

{
  "type": "object",
  "additionalProperties": true,
  "title": "get_productsDictOutput"
}

Identify the flower types and colors in a photo given by public image URL, and match each to NB8 Floral products. Stem counts are approximate.

{
  "type": "object",
  "properties": {
    "image_url": {
      "description": "Public http(s) URL of a photo of flowers, a bouquet or an arrangement.",
      "title": "Image Url",
      "type": "string"
    }
  },
  "required": [
    "image_url"
  ],
  "title": "identify_flowersArguments"
}

{
  "type": "object",
  "additionalProperties": true,
  "title": "identify_flowersDictOutput"
}

Create a one-time link to a cart on nb8floral.com pre-filled with the given products. Nothing is charged: the cart is reviewed and paid on nb8floral.com. Quantities are rounded up to whole packs and prices are recalculated from today's data. The link works once and expires after 30 minutes. Ships to the contiguous US only. Items that can't be added (pre-order, price on request, not enough stock) are returned in needs_quote.

{
  "type": "object",
  "properties": {
    "items": {
      "description": "Products and stem quantities to buy.",
      "items": {
        "$ref": "#/$defs/CartLine"
      },
      "maxItems": 40,
      "minItems": 1,
      "title": "Items",
      "type": "array"
    }
  },
  "required": [
    "items"
  ],
  "$defs": {
    "CartLine": {
      "properties": {
        "slug": {
          "description": "Product slug (pre-order items can't be added to a cart).",
          "title": "Slug",
          "type": "string"
        },
        "color": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Color wanted, e.g. 'white'.",
          "title": "Color"
        },
        "stems": {
          "description": "Total stems wanted; rounded up to whole packs.",
          "maximum": 100000,
          "minimum": 1,
          "title": "Stems",
          "type": "integer"
        }
      },
      "required": [
        "slug",
        "stems"
      ],
      "title": "CartLine",
      "type": "object"
    }
  },
  "title": "create_checkout_linkArguments"
}

{
  "type": "object",
  "additionalProperties": true,
  "title": "create_checkout_linkDictOutput"
}

Save a product list for a price quote (pre-order items, large or custom orders, or shipping outside the contiguous US) and return an order code like NB8-7K3QX. Nothing is ordered or charged; the code is sent to NB8 Floral by email or WhatsApp to receive a quote.

{
  "type": "object",
  "properties": {
    "items": {
      "description": "Products and stem quantities.",
      "items": {
        "$ref": "#/$defs/QuoteLine"
      },
      "maxItems": 60,
      "minItems": 1,
      "title": "Items",
      "type": "array"
    },
    "project_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional label, e.g. 'Smith wedding'.",
      "title": "Project Name"
    },
    "event_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional event date, YYYY-MM-DD — helps us check pre-order timing.",
      "title": "Event Date"
    }
  },
  "required": [
    "items"
  ],
  "$defs": {
    "QuoteLine": {
      "properties": {
        "slug": {
          "description": "Product slug, including pre-order slugs like 'preorder:…'.",
          "title": "Slug",
          "type": "string"
        },
        "name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Product name as shown to the user.",
          "title": "Name"
        },
        "color": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Color wanted.",
          "title": "Color"
        },
        "stems": {
          "description": "Total stems wanted.",
          "maximum": 1000000,
          "minimum": 1,
          "title": "Stems",
          "type": "integer"
        }
      },
      "required": [
        "slug",
        "stems"
      ],
      "title": "QuoteLine",
      "type": "object"
    }
  },
  "title": "create_quote_requestArguments"
}

{
  "type": "object",
  "additionalProperties": true,
  "title": "create_quote_requestDictOutput"
}