{
  "openapi": "3.1.0",
  "info": {
    "title": "SureFire Biosciences API",
    "version": "1.0.0",
    "description": "Programmatic access to SureFire Biosciences product catalog and sample/quote request system. For AI agents and integrations. No authentication required.",
    "contact": {
      "name": "SureFire Biosciences",
      "email": "contact@surefirebio.com",
      "url": "https://surefirebio.com"
    }
  },
  "servers": [
    {
      "url": "https://surefirebio.com",
      "description": "Production"
    }
  ],
  "paths": {
    "/products.json": {
      "get": {
        "operationId": "getProductCatalog",
        "summary": "Get full product catalog",
        "description": "Returns the complete SureFire Biosciences product catalog with specifications, categories, compatibility info, pricing hints, and sample availability. No authentication required. Filter client-side by category, tags, or replaces field.",
        "tags": ["Catalog"],
        "responses": {
          "200": {
            "description": "Product catalog with 17 products across 3 categories",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProductCatalog"
                },
                "example": {
                  "catalog_version": "1.0",
                  "last_updated": "2026-03-03",
                  "products": [
                    {
                      "id": "QD-V31",
                      "name": "QuantumDye Terminator v3.1 Cycle Sequencing Kit",
                      "brand": "SureFire Biosciences",
                      "category": "Sanger Sequencing Reagents",
                      "replaces": "BigDye Terminator v3.1 (Thermo Fisher/Applied Biosystems)",
                      "cost_savings": "30%+ vs BigDye equivalent",
                      "agent_pricing_hint": "Approximately 30% less than Thermo Fisher BigDye Terminator v3.1 list price",
                      "free_sample": true,
                      "tags": ["flagship", "sanger", "bigdye-replacement"]
                    }
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/contact.html": {
      "post": {
        "operationId": "requestQuoteOrSample",
        "summary": "Request a quote or free sample",
        "description": "Submit a request for a product quote or free evaluation sample. Form is processed by FormSubmit.co and forwarded to contact@surefirebio.com. NOTE: This is an HTML form endpoint, not a JSON API. The response is an HTTP 302 redirect to a thank-you page, not a JSON body. A scientist reviews every inquiry and responds within 1 business day.",
        "tags": ["Contact"],
        "requestBody": {
          "required": true,
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "$ref": "#/components/schemas/ContactRequest"
              },
              "example": {
                "fname": "Jane",
                "lname": "Smith",
                "email": "jsmith@university.edu",
                "organization": "University of Wisconsin",
                "product": "Sanger Sequencing Reagents",
                "interest": "Free Sample",
                "message": "Interested in evaluating QuantumDye v3.1 as a BigDye replacement. We run ~500 reactions/month on a 3730xl."
              }
            }
          }
        },
        "responses": {
          "302": {
            "description": "Request submitted successfully. Redirects to thank-you page. A scientist will review and respond within 1 business day."
          },
          "422": {
            "description": "Missing required fields (fname or email)."
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "ProductCatalog": {
        "type": "object",
        "properties": {
          "catalog_version": { "type": "string" },
          "last_updated": { "type": "string", "format": "date" },
          "company": {
            "type": "object",
            "properties": {
              "name": { "type": "string" },
              "phone": { "type": "string" },
              "email": { "type": "string", "format": "email" },
              "address": { "type": "string" },
              "url": { "type": "string", "format": "uri" }
            }
          },
          "pricing_policy": { "type": "string" },
          "pricing_note_for_agents": { "type": "string", "description": "Guidance for AI agents on how to communicate pricing to end users" },
          "products": {
            "type": "array",
            "items": { "$ref": "#/components/schemas/Product" }
          }
        }
      },
      "Product": {
        "type": "object",
        "properties": {
          "id": { "type": "string", "description": "Unique product identifier (e.g., QD-V31)" },
          "name": { "type": "string" },
          "brand": { "type": "string" },
          "distributed_by": { "type": "string", "description": "Present when brand differs from SureFire Biosciences" },
          "category": { "type": "string", "enum": ["Sanger Sequencing Reagents", "RNA/DNA Preservation", "Molecular QC Controls"] },
          "subcategory": { "type": "string" },
          "description": { "type": "string" },
          "replaces": { "type": "string", "description": "Competitor product this directly replaces (null if not a replacement)" },
          "cost_savings": { "type": "string" },
          "agent_pricing_hint": { "type": "string", "description": "Pricing guidance for AI agents (not displayed to humans)" },
          "specs": {
            "type": "object",
            "description": "Product-specific specifications. Keys vary by category.",
            "properties": {
              "protocol_changes_required": { "type": "boolean" },
              "compatible_instruments": { "type": "array", "items": { "type": "string" } },
              "performance_equivalence": { "type": "string" },
              "storage_temperature": { "type": "string" },
              "country_of_manufacture": { "type": "string" },
              "technology": { "type": "string" },
              "stability": { "type": "string" },
              "matrix": { "type": "string" }
            }
          },
          "free_sample": { "type": "boolean" },
          "url": { "type": "string", "description": "Relative URL to product detail page" },
          "tags": { "type": "array", "items": { "type": "string" }, "description": "Searchable tags for filtering" }
        }
      },
      "ContactRequest": {
        "type": "object",
        "required": ["fname", "email"],
        "properties": {
          "fname": { "type": "string", "description": "First name" },
          "lname": { "type": "string", "description": "Last name" },
          "email": { "type": "string", "format": "email", "description": "Email for response" },
          "phone": { "type": "string", "description": "Phone number" },
          "organization": { "type": "string", "description": "University, hospital, or company" },
          "product": {
            "type": "string",
            "enum": ["Sanger Sequencing Reagents", "RNA/DNA Preservation", "Molecular QC Controls", "Multiple Products"],
            "description": "Product line of interest"
          },
          "interest": {
            "type": "string",
            "enum": ["Free Sample", "Product Pricing", "Volume Quote", "Technical Support", "Service Contract", "Other"],
            "description": "Type of inquiry. For multiple, use the message field."
          },
          "message": { "type": "string", "description": "Details: specific products, volume, current reagents, etc." }
        }
      }
    }
  }
}