openapi.json

{
  "openapi": "3.1.0",
  "info": {
    "title": "Hospital Management Enterprise API",
    "description": "Enterprise hospital management backend covering patient administration, appointments, clinical records, pharmacy, laboratory, admissions, bed management, billing and insurance.",
    "version": "1.0.0"
  },
  "paths": {
    "/api/v1/health": {
      "get": {
        "tags": [
          "System"
        ],
        "summary": "Liveness probe",
        "operationId": "health_api_v1_health_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/api/v1/ready": {
      "get": {
        "tags": [
          "System"
        ],
        "summary": "Readiness probe",
        "operationId": "ready_api_v1_ready_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/api/v1/auth/patient-register": {
      "post": {
        "tags": [
          "Authentication"
        ],
        "summary": "Register patient portal account",
        "operationId": "patient_register_api_v1_auth_patient_register_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PatientPortalRegister"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/auth/login": {
      "post": {
        "tags": [
          "Authentication"
        ],
        "summary": "Authenticate user",
        "operationId": "login_api_v1_auth_login_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/LoginRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TokenPair"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/auth/refresh": {
      "post": {
        "tags": [
          "Authentication"
        ],
        "summary": "Rotate refresh token",
        "operationId": "refresh_api_v1_auth_refresh_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RefreshRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TokenPair"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/auth/logout": {
      "post": {
        "tags": [
          "Authentication"
        ],
        "summary": "Revoke refresh token",
        "operationId": "logout_api_v1_auth_logout_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/LogoutRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Message"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        },
        "security": [
          {
            "HTTPBearer": []
          }
        ]
      }
    },
    "/api/v1/auth/me": {
      "get": {
        "tags": [
          "Authentication"
        ],
        "summary": "Read current user",
        "operationId": "me_api_v1_auth_me_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserOut"
                }
              }
            }
          }
        },
        "security": [
          {
            "HTTPBearer": []
          }
        ]
      }
    },
    "/api/v1/admin/users": {
      "post": {
        "tags": [
          "Administration"
        ],
        "summary": "Create hospital staff user",
        "operationId": "create_user_api_v1_admin_users_post",
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UserCreate"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      },
      "get": {
        "tags": [
          "Administration"
        ],
        "summary": "List users",
        "operationId": "list_users_api_v1_admin_users_get",
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "parameters": [
          {
            "name": "role",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "$ref": "#/components/schemas/UserRole"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Role"
            }
          },
          {
            "name": "active",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Active"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/UserOut"
                  },
                  "title": "Response List Users Api V1 Admin Users Get"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/admin/users/{user_id}/active": {
      "patch": {
        "tags": [
          "Administration"
        ],
        "summary": "Activate or deactivate user",
        "operationId": "set_user_active_api_v1_admin_users__user_id__active_patch",
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "parameters": [
          {
            "name": "user_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "title": "User Id"
            }
          },
          {
            "name": "active",
            "in": "query",
            "required": true,
            "schema": {
              "type": "boolean",
              "title": "Active"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/departments": {
      "get": {
        "tags": [
          "Administration"
        ],
        "summary": "List departments",
        "operationId": "list_departments_api_v1_departments_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/DepartmentOut"
                  },
                  "type": "array",
                  "title": "Response List Departments Api V1 Departments Get"
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "Administration"
        ],
        "summary": "Create department",
        "operationId": "create_department_api_v1_departments_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DepartmentCreate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DepartmentOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        },
        "security": [
          {
            "HTTPBearer": []
          }
        ]
      }
    },
    "/api/v1/doctors": {
      "post": {
        "tags": [
          "Administration"
        ],
        "summary": "Create doctor profile",
        "operationId": "create_doctor_api_v1_doctors_post",
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DoctorProfileCreate"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DoctorProfileOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      },
      "get": {
        "tags": [
          "Administration"
        ],
        "summary": "List doctors",
        "operationId": "list_doctors_api_v1_doctors_get",
        "parameters": [
          {
            "name": "department_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Department Id"
            }
          },
          {
            "name": "specialization",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Specialization"
            }
          },
          {
            "name": "available",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "type": "null"
                }
              ],
              "default": true,
              "title": "Available"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/DoctorProfileOut"
                  },
                  "title": "Response List Doctors Api V1 Doctors Get"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/doctors/{doctor_id}/schedules": {
      "post": {
        "tags": [
          "Administration"
        ],
        "summary": "Add doctor schedule",
        "operationId": "add_schedule_api_v1_doctors__doctor_id__schedules_post",
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "parameters": [
          {
            "name": "doctor_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "title": "Doctor Id"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DoctorScheduleCreate"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DoctorScheduleOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      },
      "get": {
        "tags": [
          "Administration"
        ],
        "summary": "List doctor schedules",
        "operationId": "list_schedules_api_v1_doctors__doctor_id__schedules_get",
        "parameters": [
          {
            "name": "doctor_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "title": "Doctor Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/DoctorScheduleOut"
                  },
                  "title": "Response List Schedules Api V1 Doctors  Doctor Id  Schedules Get"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/admin/dashboard": {
      "get": {
        "tags": [
          "Administration"
        ],
        "summary": "Hospital executive dashboard",
        "operationId": "dashboard_api_v1_admin_dashboard_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DashboardOut"
                }
              }
            }
          }
        },
        "security": [
          {
            "HTTPBearer": []
          }
        ]
      }
    },
    "/api/v1/admin/audit-logs": {
      "get": {
        "tags": [
          "Administration"
        ],
        "summary": "List audit logs",
        "operationId": "audit_logs_api_v1_admin_audit_logs_get",
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "parameters": [
          {
            "name": "action",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Action"
            }
          },
          {
            "name": "entity_type",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Entity Type"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 500,
              "minimum": 1,
              "default": 100,
              "title": "Limit"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/AuditOut"
                  },
                  "title": "Response Audit Logs Api V1 Admin Audit Logs Get"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/patients": {
      "post": {
        "tags": [
          "Patients"
        ],
        "summary": "Register patient",
        "operationId": "create_patient_api_v1_patients_post",
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PatientCreate"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PatientOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      },
      "get": {
        "tags": [
          "Patients"
        ],
        "summary": "Search patients",
        "operationId": "list_patients_api_v1_patients_get",
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Q"
            }
          },
          {
            "name": "active",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "type": "null"
                }
              ],
              "default": true,
              "title": "Active"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 200,
              "minimum": 1,
              "default": 50,
              "title": "Limit"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/PatientOut"
                  },
                  "title": "Response List Patients Api V1 Patients Get"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/patients/me": {
      "get": {
        "tags": [
          "Patients"
        ],
        "summary": "Read logged-in patient's profile",
        "operationId": "my_patient_profile_api_v1_patients_me_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PatientOut"
                }
              }
            }
          }
        },
        "security": [
          {
            "HTTPBearer": []
          }
        ]
      }
    },
    "/api/v1/patients/{patient_id}": {
      "get": {
        "tags": [
          "Patients"
        ],
        "summary": "Read patient",
        "operationId": "get_patient_api_v1_patients__patient_id__get",
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "parameters": [
          {
            "name": "patient_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "title": "Patient Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PatientOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      },
      "patch": {
        "tags": [
          "Patients"
        ],
        "summary": "Update patient",
        "operationId": "update_patient_api_v1_patients__patient_id__patch",
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "parameters": [
          {
            "name": "patient_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "title": "Patient Id"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PatientUpdate"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PatientOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/appointments": {
      "post": {
        "tags": [
          "Appointments"
        ],
        "summary": "Book appointment",
        "operationId": "create_appointment_api_v1_appointments_post",
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AppointmentCreate"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AppointmentOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      },
      "get": {
        "tags": [
          "Appointments"
        ],
        "summary": "List appointments",
        "operationId": "list_appointments_api_v1_appointments_get",
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "parameters": [
          {
            "name": "patient_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Patient Id"
            }
          },
          {
            "name": "doctor_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Doctor Id"
            }
          },
          {
            "name": "appointment_status",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "$ref": "#/components/schemas/AppointmentStatus"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Appointment Status"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 500,
              "minimum": 1,
              "default": 100,
              "title": "Limit"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/AppointmentOut"
                  },
                  "title": "Response List Appointments Api V1 Appointments Get"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/appointments/{appointment_id}": {
      "get": {
        "tags": [
          "Appointments"
        ],
        "summary": "Read appointment",
        "operationId": "get_appointment_api_v1_appointments__appointment_id__get",
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "parameters": [
          {
            "name": "appointment_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "title": "Appointment Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AppointmentOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/appointments/{appointment_id}/status": {
      "patch": {
        "tags": [
          "Appointments"
        ],
        "summary": "Update appointment status",
        "operationId": "update_status_api_v1_appointments__appointment_id__status_patch",
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "parameters": [
          {
            "name": "appointment_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "title": "Appointment Id"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AppointmentStatusUpdate"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AppointmentOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/clinical/encounters": {
      "post": {
        "tags": [
          "Clinical Records"
        ],
        "summary": "Start clinical encounter",
        "operationId": "create_encounter_api_v1_clinical_encounters_post",
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/EncounterCreate"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EncounterOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      },
      "get": {
        "tags": [
          "Clinical Records"
        ],
        "summary": "List clinical encounters",
        "operationId": "list_encounters_api_v1_clinical_encounters_get",
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "parameters": [
          {
            "name": "patient_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Patient Id"
            }
          },
          {
            "name": "doctor_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Doctor Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/EncounterOut"
                  },
                  "title": "Response List Encounters Api V1 Clinical Encounters Get"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/clinical/encounters/{encounter_id}": {
      "get": {
        "tags": [
          "Clinical Records"
        ],
        "summary": "Read encounter",
        "operationId": "get_encounter_api_v1_clinical_encounters__encounter_id__get",
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "parameters": [
          {
            "name": "encounter_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "title": "Encounter Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EncounterOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      },
      "patch": {
        "tags": [
          "Clinical Records"
        ],
        "summary": "Update or close encounter",
        "operationId": "update_encounter_api_v1_clinical_encounters__encounter_id__patch",
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "parameters": [
          {
            "name": "encounter_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "title": "Encounter Id"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/EncounterUpdate"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EncounterOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/clinical/encounters/{encounter_id}/vitals": {
      "post": {
        "tags": [
          "Clinical Records"
        ],
        "summary": "Record vital signs",
        "operationId": "add_vitals_api_v1_clinical_encounters__encounter_id__vitals_post",
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "parameters": [
          {
            "name": "encounter_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "title": "Encounter Id"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/VitalSignCreate"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VitalSignOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      },
      "get": {
        "tags": [
          "Clinical Records"
        ],
        "summary": "List encounter vitals",
        "operationId": "list_vitals_api_v1_clinical_encounters__encounter_id__vitals_get",
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "parameters": [
          {
            "name": "encounter_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "title": "Encounter Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/VitalSignOut"
                  },
                  "title": "Response List Vitals Api V1 Clinical Encounters  Encounter Id  Vitals Get"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/clinical/encounters/{encounter_id}/diagnoses": {
      "post": {
        "tags": [
          "Clinical Records"
        ],
        "summary": "Add diagnosis",
        "operationId": "add_diagnosis_api_v1_clinical_encounters__encounter_id__diagnoses_post",
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "parameters": [
          {
            "name": "encounter_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "title": "Encounter Id"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DiagnosisCreate"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DiagnosisOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      },
      "get": {
        "tags": [
          "Clinical Records"
        ],
        "summary": "List encounter diagnoses",
        "operationId": "list_diagnoses_api_v1_clinical_encounters__encounter_id__diagnoses_get",
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "parameters": [
          {
            "name": "encounter_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "title": "Encounter Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/DiagnosisOut"
                  },
                  "title": "Response List Diagnoses Api V1 Clinical Encounters  Encounter Id  Diagnoses Get"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/pharmacy/medications": {
      "post": {
        "tags": [
          "Pharmacy & Prescriptions"
        ],
        "summary": "Create medication",
        "operationId": "create_medication_api_v1_pharmacy_medications_post",
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/MedicationCreate"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MedicationOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      },
      "get": {
        "tags": [
          "Pharmacy & Prescriptions"
        ],
        "summary": "Search medication catalogue",
        "operationId": "list_medications_api_v1_pharmacy_medications_get",
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Q"
            }
          },
          {
            "name": "low_stock",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean",
              "default": false,
              "title": "Low Stock"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 500,
              "minimum": 1,
              "default": 100,
              "title": "Limit"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/MedicationOut"
                  },
                  "title": "Response List Medications Api V1 Pharmacy Medications Get"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/pharmacy/medications/{medication_id}/stock": {
      "patch": {
        "tags": [
          "Pharmacy & Prescriptions"
        ],
        "summary": "Adjust medication stock",
        "operationId": "adjust_stock_api_v1_pharmacy_medications__medication_id__stock_patch",
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "parameters": [
          {
            "name": "medication_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "title": "Medication Id"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/MedicationStockUpdate"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MedicationOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/pharmacy/prescriptions": {
      "post": {
        "tags": [
          "Pharmacy & Prescriptions"
        ],
        "summary": "Create prescription",
        "operationId": "create_prescription_api_v1_pharmacy_prescriptions_post",
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PrescriptionCreate"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PrescriptionOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      },
      "get": {
        "tags": [
          "Pharmacy & Prescriptions"
        ],
        "summary": "List prescriptions",
        "operationId": "list_prescriptions_api_v1_pharmacy_prescriptions_get",
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "parameters": [
          {
            "name": "patient_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Patient Id"
            }
          },
          {
            "name": "prescription_status",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "$ref": "#/components/schemas/PrescriptionStatus"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Prescription Status"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/PrescriptionOut"
                  },
                  "title": "Response List Prescriptions Api V1 Pharmacy Prescriptions Get"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/pharmacy/prescriptions/{prescription_id}": {
      "get": {
        "tags": [
          "Pharmacy & Prescriptions"
        ],
        "summary": "Read prescription",
        "operationId": "get_prescription_api_v1_pharmacy_prescriptions__prescription_id__get",
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "parameters": [
          {
            "name": "prescription_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "title": "Prescription Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PrescriptionOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/pharmacy/prescriptions/{prescription_id}/dispense": {
      "post": {
        "tags": [
          "Pharmacy & Prescriptions"
        ],
        "summary": "Dispense prescribed medication",
        "operationId": "dispense_api_v1_pharmacy_prescriptions__prescription_id__dispense_post",
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "parameters": [
          {
            "name": "prescription_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "title": "Prescription Id"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DispenseRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PrescriptionOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/laboratory/tests": {
      "post": {
        "tags": [
          "Laboratory"
        ],
        "summary": "Create laboratory test catalogue item",
        "operationId": "create_test_api_v1_laboratory_tests_post",
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/LabTestCreate"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LabTestOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      },
      "get": {
        "tags": [
          "Laboratory"
        ],
        "summary": "List laboratory test catalogue",
        "operationId": "list_tests_api_v1_laboratory_tests_get",
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "parameters": [
          {
            "name": "active",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean",
              "default": true,
              "title": "Active"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/LabTestOut"
                  },
                  "title": "Response List Tests Api V1 Laboratory Tests Get"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/laboratory/orders": {
      "post": {
        "tags": [
          "Laboratory"
        ],
        "summary": "Order laboratory tests",
        "operationId": "create_order_api_v1_laboratory_orders_post",
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/LabOrderCreate"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LabOrderOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      },
      "get": {
        "tags": [
          "Laboratory"
        ],
        "summary": "List laboratory orders",
        "operationId": "list_orders_api_v1_laboratory_orders_get",
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "parameters": [
          {
            "name": "patient_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Patient Id"
            }
          },
          {
            "name": "lab_status",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "$ref": "#/components/schemas/LabOrderStatus"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Lab Status"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/LabOrderOut"
                  },
                  "title": "Response List Orders Api V1 Laboratory Orders Get"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/laboratory/orders/{order_id}": {
      "get": {
        "tags": [
          "Laboratory"
        ],
        "summary": "Read laboratory order",
        "operationId": "get_order_api_v1_laboratory_orders__order_id__get",
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "parameters": [
          {
            "name": "order_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "title": "Order Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LabOrderOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/laboratory/orders/{order_id}/status": {
      "patch": {
        "tags": [
          "Laboratory"
        ],
        "summary": "Update laboratory order status",
        "operationId": "update_order_status_api_v1_laboratory_orders__order_id__status_patch",
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "parameters": [
          {
            "name": "order_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "title": "Order Id"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/LabOrderStatusUpdate"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LabOrderOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/laboratory/order-items/{item_id}/result": {
      "put": {
        "tags": [
          "Laboratory"
        ],
        "summary": "Record laboratory result",
        "operationId": "record_result_api_v1_laboratory_order_items__item_id__result_put",
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "parameters": [
          {
            "name": "item_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "title": "Item Id"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/LabResultUpdate"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LabOrderOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/admissions/wards": {
      "get": {
        "tags": [
          "Admissions & Bed Management"
        ],
        "summary": "List wards",
        "operationId": "list_wards_api_v1_admissions_wards_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/WardOut"
                  },
                  "type": "array",
                  "title": "Response List Wards Api V1 Admissions Wards Get"
                }
              }
            }
          }
        },
        "security": [
          {
            "HTTPBearer": []
          }
        ]
      },
      "post": {
        "tags": [
          "Admissions & Bed Management"
        ],
        "summary": "Create ward",
        "operationId": "create_ward_api_v1_admissions_wards_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WardCreate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WardOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        },
        "security": [
          {
            "HTTPBearer": []
          }
        ]
      }
    },
    "/api/v1/admissions/rooms": {
      "post": {
        "tags": [
          "Admissions & Bed Management"
        ],
        "summary": "Create room and beds",
        "operationId": "create_room_api_v1_admissions_rooms_post",
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RoomCreate"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RoomOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      },
      "get": {
        "tags": [
          "Admissions & Bed Management"
        ],
        "summary": "List rooms",
        "operationId": "list_rooms_api_v1_admissions_rooms_get",
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "parameters": [
          {
            "name": "ward_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Ward Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/RoomOut"
                  },
                  "title": "Response List Rooms Api V1 Admissions Rooms Get"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/admissions/beds": {
      "get": {
        "tags": [
          "Admissions & Bed Management"
        ],
        "summary": "List beds and occupancy",
        "operationId": "list_beds_api_v1_admissions_beds_get",
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "parameters": [
          {
            "name": "room_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Room Id"
            }
          },
          {
            "name": "bed_status",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "$ref": "#/components/schemas/BedStatus"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Bed Status"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/BedOut"
                  },
                  "title": "Response List Beds Api V1 Admissions Beds Get"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/admissions": {
      "post": {
        "tags": [
          "Admissions & Bed Management"
        ],
        "summary": "Admit patient to bed",
        "operationId": "admit_patient_api_v1_admissions_post",
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AdmissionCreate"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AdmissionOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      },
      "get": {
        "tags": [
          "Admissions & Bed Management"
        ],
        "summary": "List admissions",
        "operationId": "list_admissions_api_v1_admissions_get",
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "parameters": [
          {
            "name": "patient_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Patient Id"
            }
          },
          {
            "name": "admission_status",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "$ref": "#/components/schemas/AdmissionStatus"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Admission Status"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/AdmissionOut"
                  },
                  "title": "Response List Admissions Api V1 Admissions Get"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/admissions/{admission_id}": {
      "get": {
        "tags": [
          "Admissions & Bed Management"
        ],
        "summary": "Read admission",
        "operationId": "get_admission_api_v1_admissions__admission_id__get",
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "parameters": [
          {
            "name": "admission_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "title": "Admission Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AdmissionOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/admissions/{admission_id}/discharge": {
      "post": {
        "tags": [
          "Admissions & Bed Management"
        ],
        "summary": "Discharge patient and release bed",
        "operationId": "discharge_api_v1_admissions__admission_id__discharge_post",
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "parameters": [
          {
            "name": "admission_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "title": "Admission Id"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DischargeRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AdmissionOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/billing/insurance/providers": {
      "get": {
        "tags": [
          "Billing & Insurance"
        ],
        "summary": "List insurance providers",
        "operationId": "list_providers_api_v1_billing_insurance_providers_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/InsuranceProviderOut"
                  },
                  "type": "array",
                  "title": "Response List Providers Api V1 Billing Insurance Providers Get"
                }
              }
            }
          }
        },
        "security": [
          {
            "HTTPBearer": []
          }
        ]
      },
      "post": {
        "tags": [
          "Billing & Insurance"
        ],
        "summary": "Create insurance provider",
        "operationId": "create_provider_api_v1_billing_insurance_providers_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/InsuranceProviderCreate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InsuranceProviderOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        },
        "security": [
          {
            "HTTPBearer": []
          }
        ]
      }
    },
    "/api/v1/billing/insurance/policies": {
      "post": {
        "tags": [
          "Billing & Insurance"
        ],
        "summary": "Create patient insurance policy",
        "operationId": "create_policy_api_v1_billing_insurance_policies_post",
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/InsurancePolicyCreate"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InsurancePolicyOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      },
      "get": {
        "tags": [
          "Billing & Insurance"
        ],
        "summary": "List patient policies",
        "operationId": "list_policies_api_v1_billing_insurance_policies_get",
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "parameters": [
          {
            "name": "patient_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Patient Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/InsurancePolicyOut"
                  },
                  "title": "Response List Policies Api V1 Billing Insurance Policies Get"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/billing/invoices": {
      "post": {
        "tags": [
          "Billing & Insurance"
        ],
        "summary": "Create invoice",
        "operationId": "create_invoice_api_v1_billing_invoices_post",
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/InvoiceCreate"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InvoiceOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      },
      "get": {
        "tags": [
          "Billing & Insurance"
        ],
        "summary": "List invoices",
        "operationId": "list_invoices_api_v1_billing_invoices_get",
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "parameters": [
          {
            "name": "patient_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Patient Id"
            }
          },
          {
            "name": "invoice_status",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "$ref": "#/components/schemas/InvoiceStatus"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Invoice Status"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/InvoiceOut"
                  },
                  "title": "Response List Invoices Api V1 Billing Invoices Get"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/billing/invoices/{invoice_id}/items": {
      "post": {
        "tags": [
          "Billing & Insurance"
        ],
        "summary": "Add invoice line item",
        "operationId": "add_invoice_item_api_v1_billing_invoices__invoice_id__items_post",
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "parameters": [
          {
            "name": "invoice_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "title": "Invoice Id"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/InvoiceItemCreate"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InvoiceOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/billing/invoices/{invoice_id}/issue": {
      "post": {
        "tags": [
          "Billing & Insurance"
        ],
        "summary": "Issue invoice",
        "operationId": "issue_invoice_api_v1_billing_invoices__invoice_id__issue_post",
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "parameters": [
          {
            "name": "invoice_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "title": "Invoice Id"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/InvoiceIssueRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InvoiceOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/billing/invoices/{invoice_id}": {
      "get": {
        "tags": [
          "Billing & Insurance"
        ],
        "summary": "Read invoice",
        "operationId": "get_invoice_api_v1_billing_invoices__invoice_id__get",
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "parameters": [
          {
            "name": "invoice_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "title": "Invoice Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InvoiceOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/billing/invoices/{invoice_id}/payments": {
      "post": {
        "tags": [
          "Billing & Insurance"
        ],
        "summary": "Record invoice payment",
        "operationId": "record_payment_api_v1_billing_invoices__invoice_id__payments_post",
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "parameters": [
          {
            "name": "invoice_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "title": "Invoice Id"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PaymentCreate"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaymentOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/billing/insurance/claims": {
      "post": {
        "tags": [
          "Billing & Insurance"
        ],
        "summary": "Create insurance claim",
        "operationId": "create_claim_api_v1_billing_insurance_claims_post",
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ClaimCreate"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ClaimOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      },
      "get": {
        "tags": [
          "Billing & Insurance"
        ],
        "summary": "List insurance claims",
        "operationId": "list_claims_api_v1_billing_insurance_claims_get",
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "parameters": [
          {
            "name": "claim_status",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "$ref": "#/components/schemas/ClaimStatus"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Claim Status"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ClaimOut"
                  },
                  "title": "Response List Claims Api V1 Billing Insurance Claims Get"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/billing/insurance/claims/{claim_id}/status": {
      "patch": {
        "tags": [
          "Billing & Insurance"
        ],
        "summary": "Process insurance claim",
        "operationId": "update_claim_api_v1_billing_insurance_claims__claim_id__status_patch",
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "parameters": [
          {
            "name": "claim_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "title": "Claim Id"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ClaimStatusUpdate"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ClaimOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "AdmissionCreate": {
        "properties": {
          "patient_id": {
            "type": "integer",
            "title": "Patient Id"
          },
          "attending_doctor_id": {
            "type": "integer",
            "title": "Attending Doctor Id"
          },
          "bed_id": {
            "type": "integer",
            "title": "Bed Id"
          },
          "reason": {
            "type": "string",
            "minLength": 3,
            "title": "Reason"
          },
          "expected_discharge_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Expected Discharge At"
          }
        },
        "type": "object",
        "required": [
          "patient_id",
          "attending_doctor_id",
          "bed_id",
          "reason"
        ],
        "title": "AdmissionCreate"
      },
      "AdmissionOut": {
        "properties": {
          "id": {
            "type": "integer",
            "title": "Id"
          },
          "admission_number": {
            "type": "string",
            "title": "Admission Number"
          },
          "patient_id": {
            "type": "integer",
            "title": "Patient Id"
          },
          "attending_doctor_id": {
            "type": "integer",
            "title": "Attending Doctor Id"
          },
          "bed_id": {
            "type": "integer",
            "title": "Bed Id"
          },
          "status": {
            "$ref": "#/components/schemas/AdmissionStatus"
          },
          "reason": {
            "type": "string",
            "title": "Reason"
          },
          "admitted_at": {
            "type": "string",
            "format": "date-time",
            "title": "Admitted At"
          },
          "expected_discharge_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Expected Discharge At"
          },
          "discharged_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Discharged At"
          },
          "discharge_summary": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Discharge Summary"
          },
          "created_by": {
            "type": "integer",
            "title": "Created By"
          }
        },
        "type": "object",
        "required": [
          "id",
          "admission_number",
          "patient_id",
          "attending_doctor_id",
          "bed_id",
          "status",
          "reason",
          "admitted_at",
          "expected_discharge_at",
          "discharged_at",
          "discharge_summary",
          "created_by"
        ],
        "title": "AdmissionOut"
      },
      "AdmissionStatus": {
        "type": "string",
        "enum": [
          "admitted",
          "discharged",
          "cancelled"
        ],
        "title": "AdmissionStatus"
      },
      "AppointmentCreate": {
        "properties": {
          "patient_id": {
            "type": "integer",
            "title": "Patient Id"
          },
          "doctor_id": {
            "type": "integer",
            "title": "Doctor Id"
          },
          "scheduled_at": {
            "type": "string",
            "format": "date-time",
            "title": "Scheduled At"
          },
          "duration_minutes": {
            "type": "integer",
            "maximum": 240.0,
            "minimum": 10.0,
            "title": "Duration Minutes",
            "default": 30
          },
          "reason": {
            "type": "string",
            "minLength": 3,
            "title": "Reason"
          },
          "notes": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Notes"
          }
        },
        "type": "object",
        "required": [
          "patient_id",
          "doctor_id",
          "scheduled_at",
          "reason"
        ],
        "title": "AppointmentCreate"
      },
      "AppointmentOut": {
        "properties": {
          "id": {
            "type": "integer",
            "title": "Id"
          },
          "appointment_number": {
            "type": "string",
            "title": "Appointment Number"
          },
          "patient_id": {
            "type": "integer",
            "title": "Patient Id"
          },
          "doctor_id": {
            "type": "integer",
            "title": "Doctor Id"
          },
          "scheduled_at": {
            "type": "string",
            "format": "date-time",
            "title": "Scheduled At"
          },
          "duration_minutes": {
            "type": "integer",
            "title": "Duration Minutes"
          },
          "reason": {
            "type": "string",
            "title": "Reason"
          },
          "status": {
            "$ref": "#/components/schemas/AppointmentStatus"
          },
          "notes": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Notes"
          },
          "created_by": {
            "type": "integer",
            "title": "Created By"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "title": "Created At"
          }
        },
        "type": "object",
        "required": [
          "id",
          "appointment_number",
          "patient_id",
          "doctor_id",
          "scheduled_at",
          "duration_minutes",
          "reason",
          "status",
          "notes",
          "created_by",
          "created_at"
        ],
        "title": "AppointmentOut"
      },
      "AppointmentStatus": {
        "type": "string",
        "enum": [
          "scheduled",
          "confirmed",
          "checked_in",
          "in_progress",
          "completed",
          "cancelled",
          "no_show"
        ],
        "title": "AppointmentStatus"
      },
      "AppointmentStatusUpdate": {
        "properties": {
          "status": {
            "$ref": "#/components/schemas/AppointmentStatus"
          },
          "notes": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Notes"
          }
        },
        "type": "object",
        "required": [
          "status"
        ],
        "title": "AppointmentStatusUpdate"
      },
      "AuditOut": {
        "properties": {
          "id": {
            "type": "integer",
            "title": "Id"
          },
          "actor_id": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Actor Id"
          },
          "action": {
            "type": "string",
            "title": "Action"
          },
          "entity_type": {
            "type": "string",
            "title": "Entity Type"
          },
          "entity_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Entity Id"
          },
          "detail": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Detail"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "title": "Created At"
          }
        },
        "type": "object",
        "required": [
          "id",
          "actor_id",
          "action",
          "entity_type",
          "entity_id",
          "detail",
          "created_at"
        ],
        "title": "AuditOut"
      },
      "BedOut": {
        "properties": {
          "id": {
            "type": "integer",
            "title": "Id"
          },
          "room_id": {
            "type": "integer",
            "title": "Room Id"
          },
          "bed_number": {
            "type": "string",
            "title": "Bed Number"
          },
          "status": {
            "$ref": "#/components/schemas/BedStatus"
          }
        },
        "type": "object",
        "required": [
          "id",
          "room_id",
          "bed_number",
          "status"
        ],
        "title": "BedOut"
      },
      "BedStatus": {
        "type": "string",
        "enum": [
          "available",
          "occupied",
          "maintenance",
          "reserved"
        ],
        "title": "BedStatus"
      },
      "BloodGroup": {
        "type": "string",
        "enum": [
          "A+",
          "A-",
          "B+",
          "B-",
          "AB+",
          "AB-",
          "O+",
          "O-",
          "unknown"
        ],
        "title": "BloodGroup"
      },
      "ClaimCreate": {
        "properties": {
          "invoice_id": {
            "type": "integer",
            "title": "Invoice Id"
          },
          "policy_id": {
            "type": "integer",
            "title": "Policy Id"
          },
          "claimed_amount": {
            "anyOf": [
              {
                "type": "number",
                "exclusiveMinimum": 0.0
              },
              {
                "type": "string",
                "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"
              }
            ],
            "title": "Claimed Amount"
          }
        },
        "type": "object",
        "required": [
          "invoice_id",
          "policy_id",
          "claimed_amount"
        ],
        "title": "ClaimCreate"
      },
      "ClaimOut": {
        "properties": {
          "id": {
            "type": "integer",
            "title": "Id"
          },
          "claim_number": {
            "type": "string",
            "title": "Claim Number"
          },
          "invoice_id": {
            "type": "integer",
            "title": "Invoice Id"
          },
          "policy_id": {
            "type": "integer",
            "title": "Policy Id"
          },
          "claimed_amount": {
            "type": "string",
            "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$",
            "title": "Claimed Amount"
          },
          "approved_amount": {
            "type": "string",
            "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$",
            "title": "Approved Amount"
          },
          "status": {
            "$ref": "#/components/schemas/ClaimStatus"
          },
          "external_reference": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "External Reference"
          },
          "rejection_reason": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Rejection Reason"
          },
          "submitted_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Submitted At"
          },
          "settled_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Settled At"
          }
        },
        "type": "object",
        "required": [
          "id",
          "claim_number",
          "invoice_id",
          "policy_id",
          "claimed_amount",
          "approved_amount",
          "status",
          "external_reference",
          "rejection_reason",
          "submitted_at",
          "settled_at"
        ],
        "title": "ClaimOut"
      },
      "ClaimStatus": {
        "type": "string",
        "enum": [
          "draft",
          "submitted",
          "under_review",
          "approved",
          "partially_approved",
          "rejected",
          "settled"
        ],
        "title": "ClaimStatus"
      },
      "ClaimStatusUpdate": {
        "properties": {
          "status": {
            "$ref": "#/components/schemas/ClaimStatus"
          },
          "approved_amount": {
            "anyOf": [
              {
                "type": "number",
                "minimum": 0.0
              },
              {
                "type": "string",
                "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"
              },
              {
                "type": "null"
              }
            ],
            "title": "Approved Amount"
          },
          "external_reference": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "External Reference"
          },
          "rejection_reason": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Rejection Reason"
          }
        },
        "type": "object",
        "required": [
          "status"
        ],
        "title": "ClaimStatusUpdate"
      },
      "DashboardOut": {
        "properties": {
          "total_patients": {
            "type": "integer",
            "title": "Total Patients"
          },
          "today_appointments": {
            "type": "integer",
            "title": "Today Appointments"
          },
          "active_admissions": {
            "type": "integer",
            "title": "Active Admissions"
          },
          "available_beds": {
            "type": "integer",
            "title": "Available Beds"
          },
          "pending_lab_orders": {
            "type": "integer",
            "title": "Pending Lab Orders"
          },
          "low_stock_medications": {
            "type": "integer",
            "title": "Low Stock Medications"
          },
          "outstanding_revenue": {
            "type": "string",
            "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$",
            "title": "Outstanding Revenue"
          },
          "collected_revenue": {
            "type": "string",
            "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$",
            "title": "Collected Revenue"
          }
        },
        "type": "object",
        "required": [
          "total_patients",
          "today_appointments",
          "active_admissions",
          "available_beds",
          "pending_lab_orders",
          "low_stock_medications",
          "outstanding_revenue",
          "collected_revenue"
        ],
        "title": "DashboardOut"
      },
      "DepartmentCreate": {
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 140,
            "minLength": 2,
            "title": "Name"
          },
          "code": {
            "type": "string",
            "maxLength": 30,
            "minLength": 2,
            "title": "Code"
          },
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Description"
          }
        },
        "type": "object",
        "required": [
          "name",
          "code"
        ],
        "title": "DepartmentCreate"
      },
      "DepartmentOut": {
        "properties": {
          "id": {
            "type": "integer",
            "title": "Id"
          },
          "name": {
            "type": "string",
            "title": "Name"
          },
          "code": {
            "type": "string",
            "title": "Code"
          },
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Description"
          },
          "is_active": {
            "type": "boolean",
            "title": "Is Active"
          }
        },
        "type": "object",
        "required": [
          "id",
          "name",
          "code",
          "description",
          "is_active"
        ],
        "title": "DepartmentOut"
      },
      "DiagnosisCreate": {
        "properties": {
          "code": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 30
              },
              {
                "type": "null"
              }
            ],
            "title": "Code"
          },
          "description": {
            "type": "string",
            "minLength": 2,
            "title": "Description"
          },
          "is_primary": {
            "type": "boolean",
            "title": "Is Primary",
            "default": false
          }
        },
        "type": "object",
        "required": [
          "description"
        ],
        "title": "DiagnosisCreate"
      },
      "DiagnosisOut": {
        "properties": {
          "id": {
            "type": "integer",
            "title": "Id"
          },
          "encounter_id": {
            "type": "integer",
            "title": "Encounter Id"
          },
          "code": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Code"
          },
          "description": {
            "type": "string",
            "title": "Description"
          },
          "is_primary": {
            "type": "boolean",
            "title": "Is Primary"
          },
          "created_by": {
            "type": "integer",
            "title": "Created By"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "title": "Created At"
          }
        },
        "type": "object",
        "required": [
          "id",
          "encounter_id",
          "code",
          "description",
          "is_primary",
          "created_by",
          "created_at"
        ],
        "title": "DiagnosisOut"
      },
      "DischargeRequest": {
        "properties": {
          "discharge_summary": {
            "type": "string",
            "minLength": 3,
            "title": "Discharge Summary"
          }
        },
        "type": "object",
        "required": [
          "discharge_summary"
        ],
        "title": "DischargeRequest"
      },
      "DispenseItem": {
        "properties": {
          "prescription_item_id": {
            "type": "integer",
            "title": "Prescription Item Id"
          },
          "quantity": {
            "type": "integer",
            "minimum": 1.0,
            "title": "Quantity"
          }
        },
        "type": "object",
        "required": [
          "prescription_item_id",
          "quantity"
        ],
        "title": "DispenseItem"
      },
      "DispenseRequest": {
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/DispenseItem"
            },
            "type": "array",
            "minItems": 1,
            "title": "Items"
          }
        },
        "type": "object",
        "required": [
          "items"
        ],
        "title": "DispenseRequest"
      },
      "DoctorProfileCreate": {
        "properties": {
          "user_id": {
            "type": "integer",
            "title": "User Id"
          },
          "department_id": {
            "type": "integer",
            "title": "Department Id"
          },
          "registration_number": {
            "type": "string",
            "maxLength": 80,
            "minLength": 3,
            "title": "Registration Number"
          },
          "specialization": {
            "type": "string",
            "maxLength": 160,
            "minLength": 2,
            "title": "Specialization"
          },
          "qualification": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Qualification"
          },
          "consultation_fee": {
            "anyOf": [
              {
                "type": "number",
                "minimum": 0.0
              },
              {
                "type": "string",
                "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"
              }
            ],
            "title": "Consultation Fee",
            "default": 0
          }
        },
        "type": "object",
        "required": [
          "user_id",
          "department_id",
          "registration_number",
          "specialization"
        ],
        "title": "DoctorProfileCreate"
      },
      "DoctorProfileOut": {
        "properties": {
          "id": {
            "type": "integer",
            "title": "Id"
          },
          "user_id": {
            "type": "integer",
            "title": "User Id"
          },
          "department_id": {
            "type": "integer",
            "title": "Department Id"
          },
          "registration_number": {
            "type": "string",
            "title": "Registration Number"
          },
          "specialization": {
            "type": "string",
            "title": "Specialization"
          },
          "qualification": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Qualification"
          },
          "consultation_fee": {
            "type": "string",
            "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$",
            "title": "Consultation Fee"
          },
          "is_available": {
            "type": "boolean",
            "title": "Is Available"
          }
        },
        "type": "object",
        "required": [
          "id",
          "user_id",
          "department_id",
          "registration_number",
          "specialization",
          "qualification",
          "consultation_fee",
          "is_available"
        ],
        "title": "DoctorProfileOut"
      },
      "DoctorScheduleCreate": {
        "properties": {
          "weekday": {
            "type": "integer",
            "maximum": 6.0,
            "minimum": 0.0,
            "title": "Weekday"
          },
          "start_time": {
            "type": "string",
            "format": "time",
            "title": "Start Time"
          },
          "end_time": {
            "type": "string",
            "format": "time",
            "title": "End Time"
          },
          "slot_minutes": {
            "type": "integer",
            "maximum": 240.0,
            "minimum": 10.0,
            "title": "Slot Minutes",
            "default": 30
          }
        },
        "type": "object",
        "required": [
          "weekday",
          "start_time",
          "end_time"
        ],
        "title": "DoctorScheduleCreate"
      },
      "DoctorScheduleOut": {
        "properties": {
          "id": {
            "type": "integer",
            "title": "Id"
          },
          "doctor_id": {
            "type": "integer",
            "title": "Doctor Id"
          },
          "weekday": {
            "type": "integer",
            "title": "Weekday"
          },
          "start_time": {
            "type": "string",
            "format": "time",
            "title": "Start Time"
          },
          "end_time": {
            "type": "string",
            "format": "time",
            "title": "End Time"
          },
          "slot_minutes": {
            "type": "integer",
            "title": "Slot Minutes"
          },
          "is_active": {
            "type": "boolean",
            "title": "Is Active"
          }
        },
        "type": "object",
        "required": [
          "id",
          "doctor_id",
          "weekday",
          "start_time",
          "end_time",
          "slot_minutes",
          "is_active"
        ],
        "title": "DoctorScheduleOut"
      },
      "EncounterCreate": {
        "properties": {
          "patient_id": {
            "type": "integer",
            "title": "Patient Id"
          },
          "doctor_id": {
            "type": "integer",
            "title": "Doctor Id"
          },
          "appointment_id": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Appointment Id"
          },
          "chief_complaint": {
            "type": "string",
            "minLength": 3,
            "title": "Chief Complaint"
          },
          "clinical_notes": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Clinical Notes"
          }
        },
        "type": "object",
        "required": [
          "patient_id",
          "doctor_id",
          "chief_complaint"
        ],
        "title": "EncounterCreate"
      },
      "EncounterOut": {
        "properties": {
          "id": {
            "type": "integer",
            "title": "Id"
          },
          "encounter_number": {
            "type": "string",
            "title": "Encounter Number"
          },
          "patient_id": {
            "type": "integer",
            "title": "Patient Id"
          },
          "doctor_id": {
            "type": "integer",
            "title": "Doctor Id"
          },
          "appointment_id": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Appointment Id"
          },
          "chief_complaint": {
            "type": "string",
            "title": "Chief Complaint"
          },
          "clinical_notes": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Clinical Notes"
          },
          "diagnosis_summary": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Diagnosis Summary"
          },
          "status": {
            "$ref": "#/components/schemas/EncounterStatus"
          },
          "started_at": {
            "type": "string",
            "format": "date-time",
            "title": "Started At"
          },
          "closed_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Closed At"
          }
        },
        "type": "object",
        "required": [
          "id",
          "encounter_number",
          "patient_id",
          "doctor_id",
          "appointment_id",
          "chief_complaint",
          "clinical_notes",
          "diagnosis_summary",
          "status",
          "started_at",
          "closed_at"
        ],
        "title": "EncounterOut"
      },
      "EncounterStatus": {
        "type": "string",
        "enum": [
          "open",
          "closed"
        ],
        "title": "EncounterStatus"
      },
      "EncounterUpdate": {
        "properties": {
          "clinical_notes": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Clinical Notes"
          },
          "diagnosis_summary": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Diagnosis Summary"
          },
          "status": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/EncounterStatus"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "type": "object",
        "title": "EncounterUpdate"
      },
      "Gender": {
        "type": "string",
        "enum": [
          "male",
          "female",
          "other",
          "undisclosed"
        ],
        "title": "Gender"
      },
      "HTTPValidationError": {
        "properties": {
          "detail": {
            "items": {
              "$ref": "#/components/schemas/ValidationError"
            },
            "type": "array",
            "title": "Detail"
          }
        },
        "type": "object",
        "title": "HTTPValidationError"
      },
      "InsurancePolicyCreate": {
        "properties": {
          "patient_id": {
            "type": "integer",
            "title": "Patient Id"
          },
          "provider_id": {
            "type": "integer",
            "title": "Provider Id"
          },
          "policy_number": {
            "type": "string",
            "maxLength": 100,
            "minLength": 2,
            "title": "Policy Number"
          },
          "member_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Member Id"
          },
          "valid_from": {
            "type": "string",
            "format": "date",
            "title": "Valid From"
          },
          "valid_until": {
            "type": "string",
            "format": "date",
            "title": "Valid Until"
          },
          "coverage_percent": {
            "anyOf": [
              {
                "type": "number",
                "maximum": 100.0,
                "minimum": 0.0
              },
              {
                "type": "string",
                "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"
              }
            ],
            "title": "Coverage Percent"
          },
          "maximum_coverage": {
            "anyOf": [
              {
                "type": "number",
                "minimum": 0.0
              },
              {
                "type": "string",
                "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"
              },
              {
                "type": "null"
              }
            ],
            "title": "Maximum Coverage"
          }
        },
        "type": "object",
        "required": [
          "patient_id",
          "provider_id",
          "policy_number",
          "valid_from",
          "valid_until",
          "coverage_percent"
        ],
        "title": "InsurancePolicyCreate"
      },
      "InsurancePolicyOut": {
        "properties": {
          "id": {
            "type": "integer",
            "title": "Id"
          },
          "patient_id": {
            "type": "integer",
            "title": "Patient Id"
          },
          "provider_id": {
            "type": "integer",
            "title": "Provider Id"
          },
          "policy_number": {
            "type": "string",
            "title": "Policy Number"
          },
          "member_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Member Id"
          },
          "valid_from": {
            "type": "string",
            "format": "date",
            "title": "Valid From"
          },
          "valid_until": {
            "type": "string",
            "format": "date",
            "title": "Valid Until"
          },
          "coverage_percent": {
            "type": "string",
            "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$",
            "title": "Coverage Percent"
          },
          "maximum_coverage": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"
              },
              {
                "type": "null"
              }
            ],
            "title": "Maximum Coverage"
          },
          "is_active": {
            "type": "boolean",
            "title": "Is Active"
          }
        },
        "type": "object",
        "required": [
          "id",
          "patient_id",
          "provider_id",
          "policy_number",
          "member_id",
          "valid_from",
          "valid_until",
          "coverage_percent",
          "maximum_coverage",
          "is_active"
        ],
        "title": "InsurancePolicyOut"
      },
      "InsuranceProviderCreate": {
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 180,
            "minLength": 2,
            "title": "Name"
          },
          "code": {
            "type": "string",
            "maxLength": 40,
            "minLength": 2,
            "title": "Code"
          },
          "contact_email": {
            "anyOf": [
              {
                "type": "string",
                "format": "email"
              },
              {
                "type": "null"
              }
            ],
            "title": "Contact Email"
          },
          "contact_phone": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Contact Phone"
          }
        },
        "type": "object",
        "required": [
          "name",
          "code"
        ],
        "title": "InsuranceProviderCreate"
      },
      "InsuranceProviderOut": {
        "properties": {
          "id": {
            "type": "integer",
            "title": "Id"
          },
          "name": {
            "type": "string",
            "title": "Name"
          },
          "code": {
            "type": "string",
            "title": "Code"
          },
          "contact_email": {
            "anyOf": [
              {
                "type": "string",
                "format": "email"
              },
              {
                "type": "null"
              }
            ],
            "title": "Contact Email"
          },
          "contact_phone": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Contact Phone"
          },
          "is_active": {
            "type": "boolean",
            "title": "Is Active"
          }
        },
        "type": "object",
        "required": [
          "id",
          "name",
          "code",
          "contact_email",
          "contact_phone",
          "is_active"
        ],
        "title": "InsuranceProviderOut"
      },
      "InvoiceCreate": {
        "properties": {
          "patient_id": {
            "type": "integer",
            "title": "Patient Id"
          },
          "appointment_id": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Appointment Id"
          },
          "admission_id": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Admission Id"
          },
          "discount": {
            "anyOf": [
              {
                "type": "number",
                "minimum": 0.0
              },
              {
                "type": "string",
                "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"
              }
            ],
            "title": "Discount",
            "default": 0
          },
          "tax_rate": {
            "anyOf": [
              {
                "type": "number",
                "maximum": 1.0,
                "minimum": 0.0
              },
              {
                "type": "string",
                "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"
              },
              {
                "type": "null"
              }
            ],
            "title": "Tax Rate"
          },
          "due_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Due At"
          },
          "notes": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Notes"
          }
        },
        "type": "object",
        "required": [
          "patient_id"
        ],
        "title": "InvoiceCreate"
      },
      "InvoiceIssueRequest": {
        "properties": {
          "due_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Due At"
          }
        },
        "type": "object",
        "title": "InvoiceIssueRequest"
      },
      "InvoiceItemCreate": {
        "properties": {
          "item_type": {
            "type": "string",
            "maxLength": 60,
            "minLength": 2,
            "title": "Item Type"
          },
          "description": {
            "type": "string",
            "maxLength": 255,
            "minLength": 2,
            "title": "Description"
          },
          "reference_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Reference Id"
          },
          "quantity": {
            "type": "integer",
            "minimum": 1.0,
            "title": "Quantity",
            "default": 1
          },
          "unit_price": {
            "anyOf": [
              {
                "type": "number",
                "minimum": 0.0
              },
              {
                "type": "string",
                "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"
              }
            ],
            "title": "Unit Price"
          }
        },
        "type": "object",
        "required": [
          "item_type",
          "description",
          "unit_price"
        ],
        "title": "InvoiceItemCreate"
      },
      "InvoiceItemOut": {
        "properties": {
          "id": {
            "type": "integer",
            "title": "Id"
          },
          "item_type": {
            "type": "string",
            "title": "Item Type"
          },
          "description": {
            "type": "string",
            "title": "Description"
          },
          "reference_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Reference Id"
          },
          "quantity": {
            "type": "integer",
            "title": "Quantity"
          },
          "unit_price": {
            "type": "string",
            "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$",
            "title": "Unit Price"
          },
          "line_total": {
            "type": "string",
            "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$",
            "title": "Line Total"
          }
        },
        "type": "object",
        "required": [
          "id",
          "item_type",
          "description",
          "reference_id",
          "quantity",
          "unit_price",
          "line_total"
        ],
        "title": "InvoiceItemOut"
      },
      "InvoiceOut": {
        "properties": {
          "id": {
            "type": "integer",
            "title": "Id"
          },
          "invoice_number": {
            "type": "string",
            "title": "Invoice Number"
          },
          "patient_id": {
            "type": "integer",
            "title": "Patient Id"
          },
          "appointment_id": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Appointment Id"
          },
          "admission_id": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Admission Id"
          },
          "status": {
            "$ref": "#/components/schemas/InvoiceStatus"
          },
          "subtotal": {
            "type": "string",
            "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$",
            "title": "Subtotal"
          },
          "discount": {
            "type": "string",
            "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$",
            "title": "Discount"
          },
          "tax_rate": {
            "type": "string",
            "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$",
            "title": "Tax Rate"
          },
          "tax": {
            "type": "string",
            "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$",
            "title": "Tax"
          },
          "insurance_adjustment": {
            "type": "string",
            "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$",
            "title": "Insurance Adjustment"
          },
          "total": {
            "type": "string",
            "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$",
            "title": "Total"
          },
          "paid_amount": {
            "type": "string",
            "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$",
            "title": "Paid Amount"
          },
          "due_amount": {
            "type": "string",
            "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$",
            "title": "Due Amount"
          },
          "issued_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Issued At"
          },
          "due_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Due At"
          },
          "notes": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Notes"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/InvoiceItemOut"
            },
            "type": "array",
            "title": "Items"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "title": "Created At"
          }
        },
        "type": "object",
        "required": [
          "id",
          "invoice_number",
          "patient_id",
          "appointment_id",
          "admission_id",
          "status",
          "subtotal",
          "discount",
          "tax_rate",
          "tax",
          "insurance_adjustment",
          "total",
          "paid_amount",
          "due_amount",
          "issued_at",
          "due_at",
          "notes",
          "items",
          "created_at"
        ],
        "title": "InvoiceOut"
      },
      "InvoiceStatus": {
        "type": "string",
        "enum": [
          "draft",
          "issued",
          "partially_paid",
          "paid",
          "void"
        ],
        "title": "InvoiceStatus"
      },
      "LabOrderCreate": {
        "properties": {
          "patient_id": {
            "type": "integer",
            "title": "Patient Id"
          },
          "encounter_id": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Encounter Id"
          },
          "ordered_by_doctor_id": {
            "type": "integer",
            "title": "Ordered By Doctor Id"
          },
          "priority": {
            "type": "string",
            "pattern": "^(routine|urgent|stat)$",
            "title": "Priority",
            "default": "routine"
          },
          "clinical_notes": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Clinical Notes"
          },
          "lab_test_ids": {
            "items": {
              "type": "integer"
            },
            "type": "array",
            "minItems": 1,
            "title": "Lab Test Ids"
          }
        },
        "type": "object",
        "required": [
          "patient_id",
          "ordered_by_doctor_id",
          "lab_test_ids"
        ],
        "title": "LabOrderCreate"
      },
      "LabOrderItemOut": {
        "properties": {
          "id": {
            "type": "integer",
            "title": "Id"
          },
          "lab_test_id": {
            "type": "integer",
            "title": "Lab Test Id"
          },
          "result_value": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Result Value"
          },
          "result_unit": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Result Unit"
          },
          "reference_range": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Reference Range"
          },
          "abnormal_flag": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Abnormal Flag"
          },
          "remarks": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Remarks"
          },
          "resulted_by": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Resulted By"
          },
          "resulted_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Resulted At"
          }
        },
        "type": "object",
        "required": [
          "id",
          "lab_test_id",
          "result_value",
          "result_unit",
          "reference_range",
          "abnormal_flag",
          "remarks",
          "resulted_by",
          "resulted_at"
        ],
        "title": "LabOrderItemOut"
      },
      "LabOrderOut": {
        "properties": {
          "id": {
            "type": "integer",
            "title": "Id"
          },
          "order_number": {
            "type": "string",
            "title": "Order Number"
          },
          "patient_id": {
            "type": "integer",
            "title": "Patient Id"
          },
          "encounter_id": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Encounter Id"
          },
          "ordered_by_doctor_id": {
            "type": "integer",
            "title": "Ordered By Doctor Id"
          },
          "status": {
            "$ref": "#/components/schemas/LabOrderStatus"
          },
          "priority": {
            "type": "string",
            "title": "Priority"
          },
          "clinical_notes": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Clinical Notes"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/LabOrderItemOut"
            },
            "type": "array",
            "title": "Items"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "title": "Created At"
          }
        },
        "type": "object",
        "required": [
          "id",
          "order_number",
          "patient_id",
          "encounter_id",
          "ordered_by_doctor_id",
          "status",
          "priority",
          "clinical_notes",
          "items",
          "created_at"
        ],
        "title": "LabOrderOut"
      },
      "LabOrderStatus": {
        "type": "string",
        "enum": [
          "ordered",
          "sample_collected",
          "processing",
          "completed",
          "cancelled"
        ],
        "title": "LabOrderStatus"
      },
      "LabOrderStatusUpdate": {
        "properties": {
          "status": {
            "$ref": "#/components/schemas/LabOrderStatus"
          }
        },
        "type": "object",
        "required": [
          "status"
        ],
        "title": "LabOrderStatusUpdate"
      },
      "LabResultUpdate": {
        "properties": {
          "result_value": {
            "type": "string",
            "minLength": 1,
            "title": "Result Value"
          },
          "result_unit": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Result Unit"
          },
          "reference_range": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Reference Range"
          },
          "abnormal_flag": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^(low|normal|high|critical)$"
              },
              {
                "type": "null"
              }
            ],
            "title": "Abnormal Flag"
          },
          "remarks": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Remarks"
          }
        },
        "type": "object",
        "required": [
          "result_value"
        ],
        "title": "LabResultUpdate"
      },
      "LabTestCreate": {
        "properties": {
          "code": {
            "type": "string",
            "maxLength": 50,
            "minLength": 2,
            "title": "Code"
          },
          "name": {
            "type": "string",
            "maxLength": 180,
            "minLength": 2,
            "title": "Name"
          },
          "specimen_type": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Specimen Type"
          },
          "price": {
            "anyOf": [
              {
                "type": "number",
                "minimum": 0.0
              },
              {
                "type": "string",
                "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"
              }
            ],
            "title": "Price",
            "default": 0
          },
          "turnaround_hours": {
            "type": "integer",
            "maximum": 720.0,
            "minimum": 1.0,
            "title": "Turnaround Hours",
            "default": 24
          },
          "reference_range": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Reference Range"
          }
        },
        "type": "object",
        "required": [
          "code",
          "name"
        ],
        "title": "LabTestCreate"
      },
      "LabTestOut": {
        "properties": {
          "id": {
            "type": "integer",
            "title": "Id"
          },
          "code": {
            "type": "string",
            "title": "Code"
          },
          "name": {
            "type": "string",
            "title": "Name"
          },
          "specimen_type": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Specimen Type"
          },
          "price": {
            "type": "string",
            "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$",
            "title": "Price"
          },
          "turnaround_hours": {
            "type": "integer",
            "title": "Turnaround Hours"
          },
          "reference_range": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Reference Range"
          },
          "is_active": {
            "type": "boolean",
            "title": "Is Active"
          }
        },
        "type": "object",
        "required": [
          "id",
          "code",
          "name",
          "specimen_type",
          "price",
          "turnaround_hours",
          "reference_range",
          "is_active"
        ],
        "title": "LabTestOut"
      },
      "LoginRequest": {
        "properties": {
          "email": {
            "type": "string",
            "format": "email",
            "title": "Email"
          },
          "password": {
            "type": "string",
            "title": "Password"
          }
        },
        "type": "object",
        "required": [
          "email",
          "password"
        ],
        "title": "LoginRequest"
      },
      "LogoutRequest": {
        "properties": {
          "refresh_token": {
            "type": "string",
            "title": "Refresh Token"
          }
        },
        "type": "object",
        "required": [
          "refresh_token"
        ],
        "title": "LogoutRequest"
      },
      "MedicationCreate": {
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 180,
            "minLength": 2,
            "title": "Name"
          },
          "generic_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Generic Name"
          },
          "sku": {
            "type": "string",
            "maxLength": 80,
            "minLength": 2,
            "title": "Sku"
          },
          "form": {
            "type": "string",
            "maxLength": 80,
            "minLength": 2,
            "title": "Form"
          },
          "strength": {
            "type": "string",
            "maxLength": 80,
            "minLength": 1,
            "title": "Strength"
          },
          "unit_price": {
            "anyOf": [
              {
                "type": "number",
                "minimum": 0.0
              },
              {
                "type": "string",
                "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"
              }
            ],
            "title": "Unit Price"
          },
          "stock_quantity": {
            "type": "integer",
            "minimum": 0.0,
            "title": "Stock Quantity",
            "default": 0
          },
          "reorder_level": {
            "type": "integer",
            "minimum": 0.0,
            "title": "Reorder Level",
            "default": 10
          }
        },
        "type": "object",
        "required": [
          "name",
          "sku",
          "form",
          "strength",
          "unit_price"
        ],
        "title": "MedicationCreate"
      },
      "MedicationOut": {
        "properties": {
          "id": {
            "type": "integer",
            "title": "Id"
          },
          "name": {
            "type": "string",
            "title": "Name"
          },
          "generic_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Generic Name"
          },
          "sku": {
            "type": "string",
            "title": "Sku"
          },
          "form": {
            "type": "string",
            "title": "Form"
          },
          "strength": {
            "type": "string",
            "title": "Strength"
          },
          "unit_price": {
            "type": "string",
            "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$",
            "title": "Unit Price"
          },
          "stock_quantity": {
            "type": "integer",
            "title": "Stock Quantity"
          },
          "reorder_level": {
            "type": "integer",
            "title": "Reorder Level"
          },
          "is_active": {
            "type": "boolean",
            "title": "Is Active"
          }
        },
        "type": "object",
        "required": [
          "id",
          "name",
          "generic_name",
          "sku",
          "form",
          "strength",
          "unit_price",
          "stock_quantity",
          "reorder_level",
          "is_active"
        ],
        "title": "MedicationOut"
      },
      "MedicationStockUpdate": {
        "properties": {
          "quantity_delta": {
            "type": "integer",
            "title": "Quantity Delta"
          },
          "reason": {
            "type": "string",
            "maxLength": 255,
            "minLength": 2,
            "title": "Reason"
          }
        },
        "type": "object",
        "required": [
          "quantity_delta",
          "reason"
        ],
        "title": "MedicationStockUpdate"
      },
      "Message": {
        "properties": {
          "message": {
            "type": "string",
            "title": "Message"
          }
        },
        "type": "object",
        "required": [
          "message"
        ],
        "title": "Message"
      },
      "PatientCreate": {
        "properties": {
          "full_name": {
            "type": "string",
            "maxLength": 160,
            "minLength": 2,
            "title": "Full Name"
          },
          "date_of_birth": {
            "type": "string",
            "format": "date",
            "title": "Date Of Birth"
          },
          "gender": {
            "$ref": "#/components/schemas/Gender"
          },
          "blood_group": {
            "$ref": "#/components/schemas/BloodGroup",
            "default": "unknown"
          },
          "phone": {
            "type": "string",
            "maxLength": 30,
            "minLength": 6,
            "title": "Phone"
          },
          "email": {
            "anyOf": [
              {
                "type": "string",
                "format": "email"
              },
              {
                "type": "null"
              }
            ],
            "title": "Email"
          },
          "address": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Address"
          },
          "emergency_contact_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Emergency Contact Name"
          },
          "emergency_contact_phone": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Emergency Contact Phone"
          },
          "allergies": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Allergies"
          },
          "chronic_conditions": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Chronic Conditions"
          }
        },
        "type": "object",
        "required": [
          "full_name",
          "date_of_birth",
          "gender",
          "phone"
        ],
        "title": "PatientCreate"
      },
      "PatientOut": {
        "properties": {
          "id": {
            "type": "integer",
            "title": "Id"
          },
          "patient_number": {
            "type": "string",
            "title": "Patient Number"
          },
          "portal_user_id": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Portal User Id"
          },
          "full_name": {
            "type": "string",
            "title": "Full Name"
          },
          "date_of_birth": {
            "type": "string",
            "format": "date",
            "title": "Date Of Birth"
          },
          "gender": {
            "$ref": "#/components/schemas/Gender"
          },
          "blood_group": {
            "$ref": "#/components/schemas/BloodGroup"
          },
          "phone": {
            "type": "string",
            "title": "Phone"
          },
          "email": {
            "anyOf": [
              {
                "type": "string",
                "format": "email"
              },
              {
                "type": "null"
              }
            ],
            "title": "Email"
          },
          "address": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Address"
          },
          "emergency_contact_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Emergency Contact Name"
          },
          "emergency_contact_phone": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Emergency Contact Phone"
          },
          "allergies": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Allergies"
          },
          "chronic_conditions": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Chronic Conditions"
          },
          "is_active": {
            "type": "boolean",
            "title": "Is Active"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "title": "Created At"
          }
        },
        "type": "object",
        "required": [
          "id",
          "patient_number",
          "portal_user_id",
          "full_name",
          "date_of_birth",
          "gender",
          "blood_group",
          "phone",
          "email",
          "address",
          "emergency_contact_name",
          "emergency_contact_phone",
          "allergies",
          "chronic_conditions",
          "is_active",
          "created_at"
        ],
        "title": "PatientOut"
      },
      "PatientPortalRegister": {
        "properties": {
          "email": {
            "type": "string",
            "format": "email",
            "title": "Email"
          },
          "full_name": {
            "type": "string",
            "maxLength": 160,
            "minLength": 2,
            "title": "Full Name"
          },
          "phone": {
            "type": "string",
            "maxLength": 30,
            "minLength": 6,
            "title": "Phone"
          },
          "password": {
            "type": "string",
            "maxLength": 128,
            "minLength": 8,
            "title": "Password"
          },
          "date_of_birth": {
            "type": "string",
            "format": "date",
            "title": "Date Of Birth"
          },
          "gender": {
            "$ref": "#/components/schemas/Gender"
          },
          "blood_group": {
            "$ref": "#/components/schemas/BloodGroup",
            "default": "unknown"
          },
          "address": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Address"
          }
        },
        "type": "object",
        "required": [
          "email",
          "full_name",
          "phone",
          "password",
          "date_of_birth",
          "gender"
        ],
        "title": "PatientPortalRegister"
      },
      "PatientUpdate": {
        "properties": {
          "full_name": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 160,
                "minLength": 2
              },
              {
                "type": "null"
              }
            ],
            "title": "Full Name"
          },
          "phone": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 30,
                "minLength": 6
              },
              {
                "type": "null"
              }
            ],
            "title": "Phone"
          },
          "email": {
            "anyOf": [
              {
                "type": "string",
                "format": "email"
              },
              {
                "type": "null"
              }
            ],
            "title": "Email"
          },
          "address": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Address"
          },
          "emergency_contact_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Emergency Contact Name"
          },
          "emergency_contact_phone": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Emergency Contact Phone"
          },
          "allergies": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Allergies"
          },
          "chronic_conditions": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Chronic Conditions"
          },
          "blood_group": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/BloodGroup"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "type": "object",
        "title": "PatientUpdate"
      },
      "PaymentCreate": {
        "properties": {
          "amount": {
            "anyOf": [
              {
                "type": "number",
                "exclusiveMinimum": 0.0
              },
              {
                "type": "string",
                "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"
              }
            ],
            "title": "Amount"
          },
          "method": {
            "$ref": "#/components/schemas/PaymentMethod"
          },
          "transaction_reference": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Transaction Reference"
          },
          "idempotency_key": {
            "type": "string",
            "maxLength": 120,
            "minLength": 6,
            "title": "Idempotency Key"
          }
        },
        "type": "object",
        "required": [
          "amount",
          "method",
          "idempotency_key"
        ],
        "title": "PaymentCreate"
      },
      "PaymentMethod": {
        "type": "string",
        "enum": [
          "cash",
          "card",
          "upi",
          "bank_transfer",
          "insurance"
        ],
        "title": "PaymentMethod"
      },
      "PaymentOut": {
        "properties": {
          "id": {
            "type": "integer",
            "title": "Id"
          },
          "payment_number": {
            "type": "string",
            "title": "Payment Number"
          },
          "invoice_id": {
            "type": "integer",
            "title": "Invoice Id"
          },
          "amount": {
            "type": "string",
            "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$",
            "title": "Amount"
          },
          "method": {
            "$ref": "#/components/schemas/PaymentMethod"
          },
          "transaction_reference": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Transaction Reference"
          },
          "received_by": {
            "type": "integer",
            "title": "Received By"
          },
          "received_at": {
            "type": "string",
            "format": "date-time",
            "title": "Received At"
          }
        },
        "type": "object",
        "required": [
          "id",
          "payment_number",
          "invoice_id",
          "amount",
          "method",
          "transaction_reference",
          "received_by",
          "received_at"
        ],
        "title": "PaymentOut"
      },
      "PrescriptionCreate": {
        "properties": {
          "encounter_id": {
            "type": "integer",
            "title": "Encounter Id"
          },
          "patient_id": {
            "type": "integer",
            "title": "Patient Id"
          },
          "doctor_id": {
            "type": "integer",
            "title": "Doctor Id"
          },
          "notes": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Notes"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/PrescriptionItemCreate"
            },
            "type": "array",
            "minItems": 1,
            "title": "Items"
          }
        },
        "type": "object",
        "required": [
          "encounter_id",
          "patient_id",
          "doctor_id",
          "items"
        ],
        "title": "PrescriptionCreate"
      },
      "PrescriptionItemCreate": {
        "properties": {
          "medication_id": {
            "type": "integer",
            "title": "Medication Id"
          },
          "dosage": {
            "type": "string",
            "title": "Dosage"
          },
          "frequency": {
            "type": "string",
            "title": "Frequency"
          },
          "duration_days": {
            "type": "integer",
            "maximum": 365.0,
            "minimum": 1.0,
            "title": "Duration Days"
          },
          "quantity_prescribed": {
            "type": "integer",
            "minimum": 1.0,
            "title": "Quantity Prescribed"
          },
          "instructions": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Instructions"
          }
        },
        "type": "object",
        "required": [
          "medication_id",
          "dosage",
          "frequency",
          "duration_days",
          "quantity_prescribed"
        ],
        "title": "PrescriptionItemCreate"
      },
      "PrescriptionItemOut": {
        "properties": {
          "id": {
            "type": "integer",
            "title": "Id"
          },
          "medication_id": {
            "type": "integer",
            "title": "Medication Id"
          },
          "dosage": {
            "type": "string",
            "title": "Dosage"
          },
          "frequency": {
            "type": "string",
            "title": "Frequency"
          },
          "duration_days": {
            "type": "integer",
            "title": "Duration Days"
          },
          "quantity_prescribed": {
            "type": "integer",
            "title": "Quantity Prescribed"
          },
          "quantity_dispensed": {
            "type": "integer",
            "title": "Quantity Dispensed"
          },
          "instructions": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Instructions"
          }
        },
        "type": "object",
        "required": [
          "id",
          "medication_id",
          "dosage",
          "frequency",
          "duration_days",
          "quantity_prescribed",
          "quantity_dispensed",
          "instructions"
        ],
        "title": "PrescriptionItemOut"
      },
      "PrescriptionOut": {
        "properties": {
          "id": {
            "type": "integer",
            "title": "Id"
          },
          "prescription_number": {
            "type": "string",
            "title": "Prescription Number"
          },
          "encounter_id": {
            "type": "integer",
            "title": "Encounter Id"
          },
          "patient_id": {
            "type": "integer",
            "title": "Patient Id"
          },
          "doctor_id": {
            "type": "integer",
            "title": "Doctor Id"
          },
          "status": {
            "$ref": "#/components/schemas/PrescriptionStatus"
          },
          "notes": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Notes"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/PrescriptionItemOut"
            },
            "type": "array",
            "title": "Items"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "title": "Created At"
          }
        },
        "type": "object",
        "required": [
          "id",
          "prescription_number",
          "encounter_id",
          "patient_id",
          "doctor_id",
          "status",
          "notes",
          "items",
          "created_at"
        ],
        "title": "PrescriptionOut"
      },
      "PrescriptionStatus": {
        "type": "string",
        "enum": [
          "active",
          "partially_dispensed",
          "dispensed",
          "cancelled"
        ],
        "title": "PrescriptionStatus"
      },
      "RefreshRequest": {
        "properties": {
          "refresh_token": {
            "type": "string",
            "title": "Refresh Token"
          }
        },
        "type": "object",
        "required": [
          "refresh_token"
        ],
        "title": "RefreshRequest"
      },
      "RoomCreate": {
        "properties": {
          "ward_id": {
            "type": "integer",
            "title": "Ward Id"
          },
          "room_number": {
            "type": "string",
            "maxLength": 40,
            "minLength": 1,
            "title": "Room Number"
          },
          "room_type": {
            "type": "string",
            "maxLength": 80,
            "minLength": 2,
            "title": "Room Type"
          },
          "daily_rate": {
            "anyOf": [
              {
                "type": "number",
                "minimum": 0.0
              },
              {
                "type": "string",
                "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"
              }
            ],
            "title": "Daily Rate",
            "default": 0
          },
          "bed_count": {
            "type": "integer",
            "maximum": 20.0,
            "minimum": 1.0,
            "title": "Bed Count",
            "default": 1
          }
        },
        "type": "object",
        "required": [
          "ward_id",
          "room_number",
          "room_type"
        ],
        "title": "RoomCreate"
      },
      "RoomOut": {
        "properties": {
          "id": {
            "type": "integer",
            "title": "Id"
          },
          "ward_id": {
            "type": "integer",
            "title": "Ward Id"
          },
          "room_number": {
            "type": "string",
            "title": "Room Number"
          },
          "room_type": {
            "type": "string",
            "title": "Room Type"
          },
          "daily_rate": {
            "type": "string",
            "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$",
            "title": "Daily Rate"
          },
          "is_active": {
            "type": "boolean",
            "title": "Is Active"
          }
        },
        "type": "object",
        "required": [
          "id",
          "ward_id",
          "room_number",
          "room_type",
          "daily_rate",
          "is_active"
        ],
        "title": "RoomOut"
      },
      "TokenPair": {
        "properties": {
          "access_token": {
            "type": "string",
            "title": "Access Token"
          },
          "refresh_token": {
            "type": "string",
            "title": "Refresh Token"
          },
          "token_type": {
            "type": "string",
            "title": "Token Type",
            "default": "bearer"
          }
        },
        "type": "object",
        "required": [
          "access_token",
          "refresh_token"
        ],
        "title": "TokenPair"
      },
      "UserCreate": {
        "properties": {
          "email": {
            "type": "string",
            "format": "email",
            "title": "Email"
          },
          "full_name": {
            "type": "string",
            "maxLength": 160,
            "minLength": 2,
            "title": "Full Name"
          },
          "phone": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 30
              },
              {
                "type": "null"
              }
            ],
            "title": "Phone"
          },
          "password": {
            "type": "string",
            "maxLength": 128,
            "minLength": 8,
            "title": "Password"
          },
          "role": {
            "$ref": "#/components/schemas/UserRole"
          }
        },
        "type": "object",
        "required": [
          "email",
          "full_name",
          "password",
          "role"
        ],
        "title": "UserCreate"
      },
      "UserOut": {
        "properties": {
          "id": {
            "type": "integer",
            "title": "Id"
          },
          "email": {
            "type": "string",
            "format": "email",
            "title": "Email"
          },
          "full_name": {
            "type": "string",
            "title": "Full Name"
          },
          "phone": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Phone"
          },
          "role": {
            "$ref": "#/components/schemas/UserRole"
          },
          "is_active": {
            "type": "boolean",
            "title": "Is Active"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "title": "Created At"
          }
        },
        "type": "object",
        "required": [
          "id",
          "email",
          "full_name",
          "phone",
          "role",
          "is_active",
          "created_at"
        ],
        "title": "UserOut"
      },
      "UserRole": {
        "type": "string",
        "enum": [
          "admin",
          "doctor",
          "nurse",
          "receptionist",
          "lab_technician",
          "pharmacist",
          "accountant",
          "insurance_officer",
          "patient"
        ],
        "title": "UserRole"
      },
      "ValidationError": {
        "properties": {
          "loc": {
            "items": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "integer"
                }
              ]
            },
            "type": "array",
            "title": "Location"
          },
          "msg": {
            "type": "string",
            "title": "Message"
          },
          "type": {
            "type": "string",
            "title": "Error Type"
          },
          "input": {
            "title": "Input"
          },
          "ctx": {
            "type": "object",
            "title": "Context"
          }
        },
        "type": "object",
        "required": [
          "loc",
          "msg",
          "type"
        ],
        "title": "ValidationError"
      },
      "VitalSignCreate": {
        "properties": {
          "temperature_c": {
            "anyOf": [
              {
                "type": "number",
                "maximum": 45.0,
                "minimum": 30.0
              },
              {
                "type": "string",
                "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"
              },
              {
                "type": "null"
              }
            ],
            "title": "Temperature C"
          },
          "pulse_bpm": {
            "anyOf": [
              {
                "type": "integer",
                "maximum": 250.0,
                "minimum": 20.0
              },
              {
                "type": "null"
              }
            ],
            "title": "Pulse Bpm"
          },
          "respiratory_rate": {
            "anyOf": [
              {
                "type": "integer",
                "maximum": 80.0,
                "minimum": 5.0
              },
              {
                "type": "null"
              }
            ],
            "title": "Respiratory Rate"
          },
          "systolic_bp": {
            "anyOf": [
              {
                "type": "integer",
                "maximum": 300.0,
                "minimum": 50.0
              },
              {
                "type": "null"
              }
            ],
            "title": "Systolic Bp"
          },
          "diastolic_bp": {
            "anyOf": [
              {
                "type": "integer",
                "maximum": 200.0,
                "minimum": 20.0
              },
              {
                "type": "null"
              }
            ],
            "title": "Diastolic Bp"
          },
          "spo2_percent": {
            "anyOf": [
              {
                "type": "integer",
                "maximum": 100.0,
                "minimum": 1.0
              },
              {
                "type": "null"
              }
            ],
            "title": "Spo2 Percent"
          },
          "height_cm": {
            "anyOf": [
              {
                "type": "number",
                "maximum": 300.0,
                "minimum": 20.0
              },
              {
                "type": "string",
                "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"
              },
              {
                "type": "null"
              }
            ],
            "title": "Height Cm"
          },
          "weight_kg": {
            "anyOf": [
              {
                "type": "number",
                "maximum": 500.0,
                "minimum": 0.5
              },
              {
                "type": "string",
                "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"
              },
              {
                "type": "null"
              }
            ],
            "title": "Weight Kg"
          }
        },
        "type": "object",
        "title": "VitalSignCreate"
      },
      "VitalSignOut": {
        "properties": {
          "id": {
            "type": "integer",
            "title": "Id"
          },
          "encounter_id": {
            "type": "integer",
            "title": "Encounter Id"
          },
          "temperature_c": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"
              },
              {
                "type": "null"
              }
            ],
            "title": "Temperature C"
          },
          "pulse_bpm": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Pulse Bpm"
          },
          "respiratory_rate": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Respiratory Rate"
          },
          "systolic_bp": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Systolic Bp"
          },
          "diastolic_bp": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Diastolic Bp"
          },
          "spo2_percent": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Spo2 Percent"
          },
          "height_cm": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"
              },
              {
                "type": "null"
              }
            ],
            "title": "Height Cm"
          },
          "weight_kg": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"
              },
              {
                "type": "null"
              }
            ],
            "title": "Weight Kg"
          },
          "recorded_by": {
            "type": "integer",
            "title": "Recorded By"
          },
          "recorded_at": {
            "type": "string",
            "format": "date-time",
            "title": "Recorded At"
          }
        },
        "type": "object",
        "required": [
          "id",
          "encounter_id",
          "temperature_c",
          "pulse_bpm",
          "respiratory_rate",
          "systolic_bp",
          "diastolic_bp",
          "spo2_percent",
          "height_cm",
          "weight_kg",
          "recorded_by",
          "recorded_at"
        ],
        "title": "VitalSignOut"
      },
      "WardCreate": {
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 120,
            "minLength": 2,
            "title": "Name"
          },
          "ward_type": {
            "type": "string",
            "maxLength": 80,
            "minLength": 2,
            "title": "Ward Type"
          },
          "floor": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Floor"
          }
        },
        "type": "object",
        "required": [
          "name",
          "ward_type"
        ],
        "title": "WardCreate"
      },
      "WardOut": {
        "properties": {
          "id": {
            "type": "integer",
            "title": "Id"
          },
          "name": {
            "type": "string",
            "title": "Name"
          },
          "ward_type": {
            "type": "string",
            "title": "Ward Type"
          },
          "floor": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Floor"
          },
          "is_active": {
            "type": "boolean",
            "title": "Is Active"
          }
        },
        "type": "object",
        "required": [
          "id",
          "name",
          "ward_type",
          "floor",
          "is_active"
        ],
        "title": "WardOut"
      }
    },
    "securitySchemes": {
      "HTTPBearer": {
        "type": "http",
        "scheme": "bearer"
      }
    }
  },
  "tags": [
    {
      "name": "Authentication",
      "description": "JWT login, refresh rotation, logout and patient portal registration."
    },
    {
      "name": "Administration",
      "description": "Staff, departments, doctors, schedules, dashboard and audit logs."
    },
    {
      "name": "Patients",
      "description": "Patient registration, search and demographic records."
    },
    {
      "name": "Appointments",
      "description": "Appointment booking and controlled lifecycle transitions."
    },
    {
      "name": "Clinical Records",
      "description": "Encounters, vital signs and diagnoses."
    },
    {
      "name": "Pharmacy & Prescriptions",
      "description": "Medication catalogue, inventory, prescriptions and dispensing."
    },
    {
      "name": "Laboratory",
      "description": "Test catalogue, orders, sample workflow and results."
    },
    {
      "name": "Admissions & Bed Management",
      "description": "Wards, rooms, beds, admissions and discharge."
    },
    {
      "name": "Billing & Insurance",
      "description": "Invoices, payments, providers, policies and claims."
    },
    {
      "name": "System",
      "description": "Liveness and readiness probes."
    }
  ]
}