Standard Blanks

Search Standard Blanks' blank apparel by keywords and filters. Returns up to 20 products with name, brand, slug, the lowest single-unit price ("from" price, in cents), availability, image and product page URL. When the query names a color or size, matchedColors lists the colors of that style that match (best first) and url opens the page on that color; an empty matchedColors for a query that named a color means that style is not sold in it. signal reports typo corrections and any words the search had to drop. Use the slug with get_product.

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Keywords: brand, style number or product words, e.g. 'heavyweight hoodie' or 'bella canvas 3001'.",
      "type": "string",
      "maxLength": 200
    },
    "category": {
      "description": "Category slug.",
      "type": "string",
      "enum": [
        "accessories",
        "bags",
        "bottoms",
        "fleece-core-crew",
        "fleece-core-hood",
        "fleece-premium-crew",
        "fleece-premium-hood",
        "headwear",
        "infant-baby",
        "knits-layering",
        "outerwear",
        "polos",
        "t-shirts-core",
        "t-shirts-long-sleeve",
        "t-shirts-premium",
        "wovens"
      ]
    },
    "brand": {
      "description": "Exact brand name, e.g. 'BELLA + CANVAS'.",
      "type": "string",
      "maxLength": 100
    },
    "color": {
      "description": "Color family.",
      "type": "string",
      "enum": [
        "blacks",
        "whites",
        "greys",
        "blues",
        "reds",
        "greens",
        "yellows",
        "oranges",
        "purples",
        "pinks",
        "browns",
        "neutrals",
        "others"
      ]
    },
    "size": {
      "description": "Only styles offered in this size.",
      "type": "string",
      "enum": [
        "xxs",
        "xs",
        "s",
        "m",
        "l",
        "xl",
        "2xl",
        "3xl",
        "4xl",
        "5xl",
        "6xl",
        "tall"
      ]
    },
    "max_price": {
      "description": "Highest single-unit price, in US dollars.",
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 10000
    },
    "in_stock": {
      "description": "Only styles with stock now.",
      "type": "boolean"
    },
    "limit": {
      "description": "Results to return (default 10).",
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Details for one product, by slug (from search_catalog) or by any of its variant SKUs: description, colors with images and availability, sizes, the size chart (garment measurements), fabric specs, and how well it takes each decoration method (screen print, DTG, embroidery, sublimation, heat-transfer vinyl, discharge, DTF). Pass `color` to also get that color's sizes, each with its SKU and availability.

{
  "type": "object",
  "properties": {
    "slug": {
      "description": "Product slug from search_catalog.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "sku": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "A variant SKU from get_product (called with a color)."
    },
    "color": {
      "description": "A color name exactly as listed in `colors`.",
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Whether one variant is available now: in_stock, low (a dozen or fewer), out_of_stock, or unknown. Pass its SKU, or the product slug with color and size.

{
  "type": "object",
  "properties": {
    "sku": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "A variant SKU from get_product (called with a color)."
    },
    "slug": {
      "description": "Product slug, with color and size.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "color": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "size": {
      "type": "string",
      "minLength": 1,
      "maxLength": 20
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Exact prices for a set of SKUs and quantities, as the Standard Blanks cart would charge them: each line's unit price (set by its style's total units), the merchandise subtotal, shipping, and the total before tax. Pass ship_to_zip for that ZIP's shipping and estimated delivery dates (estimates, not guarantees); without it, shipping assumes a contiguous-US address and no dates are given. Sales tax is calculated at checkout. Creates nothing.

{
  "type": "object",
  "properties": {
    "items": {
      "minItems": 1,
      "maxItems": 40,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "sku": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64,
            "description": "A variant SKU from get_product (called with a color)."
          },
          "qty": {
            "type": "integer",
            "minimum": 1,
            "maximum": 10000,
            "description": "Units of this SKU."
          }
        },
        "required": [
          "sku",
          "qty"
        ]
      },
      "description": "1–40 lines."
    },
    "ship_to_zip": {
      "description": "5-digit US ZIP code.",
      "type": "string",
      "pattern": "^\\d{5}$"
    }
  },
  "required": [
    "items"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Create a cart of SKUs and quantities and return a link (claimUrl) that opens it in the shopper's cart on standardblanks.com, where they review it and check out. It does not take payment or place an order. Give the shopper the link. Limits: 40 lines, $5,000 of merchandise; the link works for 7 days.

{
  "type": "object",
  "properties": {
    "items": {
      "minItems": 1,
      "maxItems": 40,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "sku": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64,
            "description": "A variant SKU from get_product (called with a color)."
          },
          "qty": {
            "type": "integer",
            "minimum": 1,
            "maximum": 10000,
            "description": "Units of this SKU."
          }
        },
        "required": [
          "sku",
          "qty"
        ]
      },
      "description": "1–40 lines."
    },
    "note": {
      "description": "Optional context for our support team, e.g. what the order is for. Not shown on the cart.",
      "type": "string",
      "maxLength": 500
    }
  },
  "required": [
    "items"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}