{
  "openapi": "3.1.0",
  "info": {
    "title": "HELiXVi Healthcare API",
    "description": "AI powered healthcare platform API. Access treatment information, pricing, eligibility criteria, and provider details for GLP-1 weight loss, men's health, women's health, peptides, hair restoration, skincare, meals, and supplements.",
    "version": "1.0.0",
    "contact": {
      "name": "HELiXVi Support",
      "email": "hello@helixvi.ai",
      "url": "https://helixvi.ai"
    }
  },
  "servers": [
    {
      "url": "https://helixvi.ai/api",
      "description": "HELiXVi Production API"
    }
  ],
  "paths": {
    "/treatments": {
      "get": {
        "operationId": "getTreatments",
        "summary": "Get all available treatments",
        "description": "Returns a list of all treatment programmes available through HELiXVi including pricing, descriptions, and availability status.",
        "responses": {
          "200": {
            "description": "List of treatments",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Treatment"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/treatments/{slug}": {
      "get": {
        "operationId": "getTreatmentBySlug",
        "summary": "Get a specific treatment by slug",
        "description": "Returns detailed information about a specific treatment programme.",
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "enum": ["glp1-weight-loss", "mens-health", "womens-health", "peptides", "hair-restoration", "skincare", "meals", "supplements"]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Treatment details"
          }
        }
      }
    },
    "/eligibility": {
      "get": {
        "operationId": "checkEligibility",
        "summary": "Check general eligibility criteria",
        "description": "Returns general eligibility criteria for GLP-1 and other treatments. Note: actual eligibility requires a full medical evaluation by a licensed provider.",
        "responses": {
          "200": {
            "description": "Eligibility criteria"
          }
        }
      }
    },
    "/pricing": {
      "get": {
        "operationId": "getPricing",
        "summary": "Get current pricing for all treatments",
        "description": "Returns pricing information for all available treatment programmes.",
        "responses": {
          "200": {
            "description": "Pricing information"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Treatment": {
        "type": "object",
        "properties": {
          "name": { "type": "string" },
          "slug": { "type": "string" },
          "description": { "type": "string" },
          "status": { "type": "string", "enum": ["active", "coming_soon"] },
          "starting_price_usd": { "type": "number" },
          "starting_price_gbp": { "type": "number" },
          "features": { "type": "array", "items": { "type": "string" } },
          "url": { "type": "string" }
        }
      }
    }
  }
}