{
  "openapi": "3.1.0",
  "info": {
    "title": "OncoCare Public Oncology & Clinical Gateway API",
    "description": "Public API specification for OncoCare by Toshiko Health. Enables AI agents, conversational assistants (ChatGPT, Claude, Gemini, Copilot), and institutional EHR systems to discover clinical capabilities, access ICMR ethical AI guidelines, submit contact inquiries, and request hospital product demonstrations.",
    "version": "1.0.0",
    "contact": {
      "name": "OncoCare Clinical Support Desk",
      "email": "support@toshikohealth.com",
      "url": "https://www.oncocare.tech/contact/"
    }
  },
  "servers": [
    {
      "url": "https://kp2ygr0hed.execute-api.eu-north-1.amazonaws.com/prod",
      "description": "Production AWS Lambda & API Gateway Server"
    },
    {
      "url": "https://www.oncocare.tech",
      "description": "Canonical Production Web Domain"
    }
  ],
  "paths": {
    "/api/public/icmr-ai-guidelines": {
      "get": {
        "summary": "Retrieve ICMR Ethical Guidelines for Oncology AI",
        "description": "Returns the active ICMR 2023 ethical principles and operational clinical safeguards implemented across OncoCare AI features.",
        "operationId": "getIcmrAiGuidelines",
        "responses": {
          "200": {
            "description": "Successful retrieval of ICMR ethical principles",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/api/public/demo-request": {
      "post": {
        "summary": "Schedule an Institutional Oncology EMR Demonstration",
        "description": "Submits a request for a 30-minute personalized clinical demonstration of OncoCare EMR, Daycare Chair Management, or Virtual Tumor Boards for cancer centers and oncologists.",
        "operationId": "submitDemoRequest",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": ["fullName", "email", "hospital"],
                "properties": {
                  "fullName": { "type": "string", "example": "Dr. Rajesh Sharma" },
                  "hospital": { "type": "string", "example": "Apollo Cancer Institute" },
                  "email": { "type": "string", "format": "email", "example": "rajesh.sharma@apollocancer.com" },
                  "phone": { "type": "string", "example": "+91 98765 43210" },
                  "role": { "type": "string", "example": "Chief Medical Oncologist" },
                  "products": { "type": "string", "example": "Oncology EMR, Ambient Scribe, Virtual Tumor Board" },
                  "preferredDate": { "type": "string", "example": "2026-11-10" },
                  "preferredTime": { "type": "string", "example": "15:00" },
                  "timezone": { "type": "string", "example": "IST (UTC+5:30)" },
                  "notes": { "type": "string", "example": "Interested in daycare chair optimization and ABHA integration." }
                }
              }
            }
          },
          "responses": {
            "200": {
              "description": "Demo request received successfully",
              "content": {
                "application/json": {
                  "schema": {
                    "type": "object"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/public/contact-inquiry": {
      "post": {
        "summary": "Submit a General or Clinical Operations Inquiry",
        "description": "Dispatches an inquiry to the Toshiko Health operations team (support@toshikohealth.com) with automated CC to leadership and confirmation to the requester's email.",
        "operationId": "submitContactInquiry",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": ["fullName", "email", "message"],
                "properties": {
                  "fullName": { "type": "string", "example": "Dr. Sunita Rao" },
                  "email": { "type": "string", "format": "email", "example": "sunita.rao@oncocare.tech" },
                  "phone": { "type": "string", "example": "+91 99887 76655" },
                  "role": { "type": "string", "enum": ["doctor", "hospital", "patient", "billing", "partner"], "example": "doctor" },
                  "message": { "type": "string", "example": "Would like to inquire about multi-center tumor board trials." }
                }
              }
            }
          },
          "responses": {
            "200": {
              "description": "Inquiry received and confirmation emails dispatched",
              "content": {
                "application/json": {
                  "schema": {
                    "type": "object"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/public/feature-flags": {
      "get": {
        "summary": "Fetch Active Public System Feature Flags",
        "description": "Returns configuration flags such as Ambient Scribe availability, ABHA sync state, and clinical modules status.",
        "operationId": "getFeatureFlags",
        "responses": {
          "200": {
            "description": "Feature flags map",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    }
  }
}