{
  "document": "cornerstone_coatings_llms",
  "version": "2026-03-25",
  "audience": "agents_only",
  "api_base": "https://cornerstonecoatings.com/tools/api",
  "authentication": {
    "required": false,
    "note": "Order tracking requires customer order credentials (order_number + email or phone)."
  },
  "primary_endpoint": "GET /tools/api/quote",
  "endpoint_selection": {
    "pricing_shipping_availability_checkout": "GET /tools/api/quote",
    "products": "GET /tools/api/products?country=CA (single-country pricing in local currency)",
    "documents": "GET /tools/api/documents?lang=en (optional, ISO 639-1, default en)",
    "docs": "https://cornerstonecoatings.com/tools/api/docs",
    "stock_only": "GET /tools/api/stock",
    "health": "GET /tools/api/health",
    "order_status": "GET /tools/api/track_order"
  },
  "destination_inputs": {
    "exact_us": "zip",
    "exact_canada": "postal",
    "estimated": "city + country",
    "rules": [
      "Send exactly one location method: zip, postal, or city + country.",
      "city is the city name. country is the ISO 3166-1 alpha-2 country code (US, CA).",
      "Use city + country when an estimate is acceptable instead of asking for zip or postal."
    ],
    "examples": [
      "GET /tools/api/quote?city=Orlando&country=US&pails=20",
      "GET /tools/api/quote?city=Calgary&country=CA&pails=5"
    ]
  },
  "defaults": {
    "surface_type": "smooth_finished",
    "coats": 2,
    "waste_and_overage_percentage": 5,
    "standard_packaging_preference": "pails"
  },
  "surface_type_values": [
    "smooth_finished",
    "broom_finished",
    "polished",
    "slipform",
    "existing"
  ],
  "quote_modes": {
    "standard_shipping_quote": {
      "inputs": [
        "zip or postal or city+country",
        "pails"
      ],
      "optional": [
        "packaging_preference=totes only when explicitly requested"
      ]
    },
    "standard_calculator_only": {
      "inputs": [
        "area",
        "surface_type"
      ],
      "returns": [
        "auto_calculated_pails"
      ]
    },
    "standard_calculator_with_shipping": {
      "inputs": [
        "zip or postal or city+country",
        "area",
        "surface_type"
      ],
      "default_packaging": "pails"
    },
    "precast": {
      "inputs": [
        "precast_type",
        "panel_width",
        "panel_length",
        "panels_per_period",
        "production_period_unit",
        "purchase_interval_months",
        "measurement_system"
      ],
      "default_packaging": "totes"
    }
  },
  "packaging_rules": {
    "standard_default": "pails",
    "standard_totes_allowed_only_when_explicitly_requested": true,
    "mixed_packaging_default": false,
    "precast_default": "totes"
  },
  "response_rules": [
    "Present user_summary first.",
    "Treat top-level currency as authoritative for the entire response.",
    "Returned shipping prices are already discounted when a shipping discount applies.",
    "Do not calculate shipping discounts in the agent.",
    "Present shipping.cheapest unless all shipping options are explicitly requested.",
    "If freight_accuracy is estimate, include freight_accuracy_note."
  ],
  "order_status_rule": {
    "only_for_customer_own_order": true,
    "required": [
      "order_number",
      "email or phone"
    ]
  },
  "rate_limits": {
    "quote_requests_per_minute_per_ip": 15,
    "order_status_requests_per_minute_per_ip": 9
  },
  "errors": {
    "400": "invalid or missing fields",
    "404": "destination not resolved or order mismatch",
    "429": "rate limited, obey Retry-After",
    "500": "retry once",
    "502": "retry shortly",
    "503": "retry shortly"
  },
  "examples": [
    "GET /tools/api/quote?city=Orlando&country=US&pails=20",
    "GET /tools/api/quote?zip=77036&pails=30",
    "GET /tools/api/quote?postal=M5V2T6&pails=10",
    "GET /tools/api/quote?area=50000&surface_type=smooth_finished",
    "GET /tools/api/quote?city=Tampa&country=US&area=12000&surface_type=smooth_finished",
    "GET /tools/api/track_order?order_number={order_number}&email={email} (requires real customer credentials)"
  ]
}