{
  "openapi": "3.1.0",
  "info": {
    "title": "Call Center Options Practice Intake & Discovery API",
    "version": "1.0.0",
    "description": "HIPAA-trained Virtual Medical Front Desk staffing intake, provider onboarding, and clinical capability discovery API."
  },
  "servers": [
    {
      "url": "https://ccoptions.net",
      "description": "Production Server"
    }
  ],
  "paths": {
    "/leads": {
      "post": {
        "summary": "Submit Medical Practice Staffing Intake",
        "description": "Submits an intake consultation inquiry for dedicated clinical FTE specialists (minimum 1 FTE).",
        "operationId": "submitClinicIntake",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "clinic_name",
                  "contact_name",
                  "email",
                  "phone",
                  "requested_ftes"
                ],
                "properties": {
                  "clinic_name": {
                    "type": "string",
                    "description": "Healthcare clinic, medical practice, or physician group name"
                  },
                  "contact_name": {
                    "type": "string",
                    "description": "Practice administrator, physician owner, or office manager name"
                  },
                  "email": {
                    "type": "string",
                    "format": "email",
                    "description": "Business or clinical contact email address"
                  },
                  "phone": {
                    "type": "string",
                    "description": "Direct callback phone number"
                  },
                  "ehr_system": {
                    "type": "string",
                    "description": "Current EHR/PM software (e.g., Epic, Athenahealth, eClinicalWorks, NextGen)"
                  },
                  "requested_ftes": {
                    "type": "integer",
                    "minimum": 1,
                    "description": "Number of dedicated full-time specialists required (minimum 1 FTE)"
                  },
                  "service_intent": {
                    "type": "string",
                    "enum": ["scheduling", "authorizations", "data-entry", "all"],
                    "description": "Primary clinical administrative service required"
                  },
                  "message": {
                    "type": "string",
                    "description": "Clinical workflow context, specialty, or onboarding timeline notes"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Intake successfully received and queued for clinical staffing director review",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "example": "success"
                    },
                    "message": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "Validation error (e.g., missing required fields or requested FTEs < 1)"
          }
        }
      }
    },
    "/health": {
      "get": {
        "summary": "Service Health Check",
        "description": "Returns operational status of the Call Center Options platform and intake pipeline.",
        "operationId": "getServiceHealth",
        "responses": {
          "200": {
            "description": "Service operational",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "example": "ok"
                    },
                    "timestamp": {
                      "type": "string",
                      "format": "date-time"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}