{ "openapi": "3.0.1", "info": { "title": "Quality Measure Service - HEDIS Quality Measures API", "description": "REST API for calculating and reporting HEDIS quality measures.\n\n**Features:**\n- Calculate quality measures for individual patients\n- Retrieve quality measure results and history\n- Generate quality scores and compliance rates\n- Multi-tenant support via X-Tenant-ID header\n- Integration with CQL Engine for measure evaluation\n- Redis caching for performance\n- Event-driven architecture with Kafka\n\n**Supported Measures:**\n- Comprehensive Diabetes Care (CDC)\n- Controlling High Blood Pressure (CBP)\n- Breast Cancer Screening (BCS)\n- Cervical Cancer Screening (CCS)\n- Colorectal Cancer Screening (COL)\n- And more HEDIS measures...\n\n**Last spec refresh:** openapi-quality-measure-v1.3.4.json \u2192 openapi-quality-measure-v1.3.5.json; static path refresh from controller source via scripts/docs/refresh_quality_measure_openapi.py \u2014 added 4 new paths, removed 0 dead paths. Runtime springdoc refresh still pending for full schema fidelity.", "contact": { "name": "HealthData-in-Motion Team", "email": "support@healthdata-in-motion.com" }, "license": { "name": "Apache 2.0", "url": "https://www.apache.org/licenses/LICENSE-2.0.html" }, "version": "1.0.13" }, "tags": [ { "name": "Result Signing", "description": "APIs for signing quality measure results" }, { "name": "Provider Performance", "description": "Provider performance metrics and analytics" }, { "name": "Actuator", "description": "Monitor and interact", "externalDocs": { "description": "Spring Boot Actuator Web API Documentation", "url": "https://docs.spring.io/spring-boot/docs/current/actuator-api/html/" } }, { "name": "Custom Measures", "description": "Custom quality measure management" } ], "paths": { "/quality-measure/custom-measures/{id}": { "get": { "tags": [ "Custom Measures" ], "operationId": "getById", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/CustomMeasureEntity" } } } } } }, "put": { "tags": [ "Custom Measures" ], "operationId": "updateDraft", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateCustomMeasureRequest" } } }, "required": true }, "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/CustomMeasureEntity" } } } } } }, "delete": { "tags": [ "Custom Measures" ], "summary": "Delete a custom measure (soft delete)", "operationId": "delete", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK" } } } }, "/patient-health/care-gaps/{gapId}/address": { "put": { "tags": [ "patient-health-controller" ], "operationId": "addressCareGap", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "gapId", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AddressCareGapRequest" } } }, "required": true }, "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CareGapDTO" } } } } } } }, "/templates/preview/{templateId}": { "get": { "tags": [ "template-preview-controller" ], "operationId": "previewTemplateWithDefaults", "parameters": [ { "name": "templateId", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "channel", "in": "query", "required": false, "schema": { "type": "string", "default": "EMAIL" } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "text/html": { "schema": { "type": "string" } } } } } }, "post": { "tags": [ "template-preview-controller" ], "operationId": "previewTemplateWithCustomData", "parameters": [ { "name": "templateId", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } }, "required": true }, "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "text/html": { "schema": { "type": "string" } } } } } } }, "/quality-measure/report/population/save": { "post": { "tags": [ "quality-measure-controller" ], "operationId": "savePopulationReport", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "year", "in": "query", "required": true, "schema": { "type": "integer", "format": "int32" } }, { "name": "name", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "createdBy", "in": "query", "required": false, "schema": { "type": "string", "default": "system" } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SavedReportEntity" } } } } } } }, "/quality-measure/report/patient/save": { "post": { "tags": [ "quality-measure-controller" ], "operationId": "savePatientReport", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "patient", "in": "query", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "name", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "createdBy", "in": "query", "required": false, "schema": { "type": "string", "default": "system" } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SavedReportEntity" } } } } } } }, "/quality-measure/population/jobs/{jobId}/cancel": { "post": { "tags": [ "quality-measure-controller" ], "operationId": "cancelJob", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "jobId", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": { "type": "string" } } } } } } } }, "/quality-measure/population/calculate": { "post": { "tags": [ "quality-measure-controller" ], "operationId": "startPopulationCalculation", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "fhirServerUrl", "in": "query", "required": false, "schema": { "type": "string", "default": "https://fhir.example.org/fhir" } }, { "name": "createdBy", "in": "query", "required": false, "schema": { "type": "string", "default": "system" } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": { "type": "string" } } } } } } } }, "/quality-measure/custom-measures": { "get": { "tags": [ "Custom Measures" ], "operationId": "list", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/CustomMeasureEntity" } } } } } } }, "post": { "tags": [ "Custom Measures" ], "operationId": "createDraft", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateCustomMeasureRequest" } } }, "required": true }, "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/CustomMeasureEntity" } } } } } } }, "/quality-measure/custom-measures/batch-publish": { "post": { "tags": [ "Custom Measures" ], "summary": "Batch publish draft measures", "description": "Publish multiple draft measures at once. Only DRAFT measures will be published, others will be skipped.", "operationId": "batchPublish", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BatchPublishRequest" } } }, "required": true }, "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/BatchPublishResponse" } } } } } } }, "/quality-measure/calculate": { "post": { "tags": [ "quality-measure-controller" ], "operationId": "calculateMeasure", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "patient", "in": "query", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "measure", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "createdBy", "in": "query", "required": false, "schema": { "type": "string", "default": "system" } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QualityMeasureResultDTO" } } } } } } }, "/patient-health/risk-stratification/{patientId}/calculate": { "post": { "tags": [ "patient-health-controller" ], "operationId": "calculateRiskStratification", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "patientId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RiskAssessmentDTO" } } } } } } }, "/patient-health/mental-health/assessments": { "post": { "tags": [ "patient-health-controller" ], "operationId": "submitMentalHealthAssessment", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MentalHealthAssessmentRequest" } } }, "required": true }, "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MentalHealthAssessmentDTO" } } } } } } }, "/cds/evaluate": { "post": { "tags": [ "cds-controller" ], "operationId": "evaluateRules", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CdsEvaluateRequest" } } }, "required": true }, "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CdsEvaluateResponse" } } } } } } }, "/cds/acknowledge": { "post": { "tags": [ "cds-controller" ], "operationId": "acknowledgeRecommendation", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CdsAcknowledgeRequest" } } }, "required": true }, "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CdsRecommendationDTO" } } } } } } }, "/api/v1/results/bulk-sign": { "post": { "tags": [ "Result Signing" ], "summary": "Bulk sign results", "description": "Sign multiple quality measure results at once. Abnormal results require individual acknowledgment.", "operationId": "bulkSignResults", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "description": "Tenant ID", "required": true, "schema": { "type": "string" } }, { "name": "X-Auth-User-Id", "in": "header", "description": "User ID from authentication", "required": true, "schema": { "type": "string" } }, { "name": "X-Auth-Username", "in": "header", "description": "Username from authentication", "required": false, "schema": { "type": "string", "default": "unknown" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BulkSignRequest" } } }, "required": true }, "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Invalid request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "Bulk sign completed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BulkSignResponse" } } } }, "403": { "description": "Forbidden - insufficient permissions", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BulkSignResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BulkSignResponse" } } } } } } }, "/api/v1/measures/{measureId}/versions": { "get": { "tags": [ "measure-version-controller" ], "operationId": "getVersionHistory", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "measureId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "page", "in": "query", "required": false, "schema": { "minimum": 0, "type": "integer", "format": "int32", "default": 0 } }, { "name": "size", "in": "query", "required": false, "schema": { "minimum": 0, "type": "integer", "format": "int32", "default": 20 } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PageMeasureVersionDTO" } } } } } }, "post": { "tags": [ "measure-version-controller" ], "operationId": "createVersion", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "X-Auth-User-Id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "X-Auth-Username", "in": "header", "required": false, "schema": { "type": "string" } }, { "name": "measureId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateVersionRequest" } } }, "required": true }, "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MeasureVersionDTO" } } } } } } }, "/api/v1/measures/{measureId}/versions/{version}/publish": { "post": { "tags": [ "measure-version-controller" ], "operationId": "publishVersion", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "X-Auth-User-Id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "measureId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "version", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MeasureVersionDTO" } } } } } } }, "/api/v1/measures/{measureId}/versions/{version}/current": { "post": { "tags": [ "measure-version-controller" ], "operationId": "setCurrentVersion", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "measureId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "version", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MeasureVersionDTO" } } } } } } }, "/api/v1/measures/{measureId}/versions/initial": { "post": { "tags": [ "measure-version-controller" ], "operationId": "createInitialVersion", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "X-Auth-User-Id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "X-Auth-Username", "in": "header", "required": false, "schema": { "type": "string" } }, { "name": "measureId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": { "type": "string" } } } }, "required": true }, "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MeasureVersionDTO" } } } } } } }, "/api/v1/measures/seed": { "post": { "tags": [ "measure-seeding-controller" ], "operationId": "seedMeasures", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeedResponse" } } } } } } }, "/api/v1/measures/ai/validate-cql": { "post": { "tags": [ "ai-measure-controller" ], "operationId": "validateCql", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CqlValidateRequest" } } }, "required": true }, "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CqlGenerationResponse" } } } } } } }, "/api/v1/measures/ai/generate-cql": { "post": { "tags": [ "ai-measure-controller" ], "operationId": "generateCql", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CqlGenerationRequest" } } }, "required": true }, "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CqlGenerationResponse" } } } } } } }, "/api/v1/measures/ai/explain-cql": { "post": { "tags": [ "ai-measure-controller" ], "operationId": "explainCql", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CqlExplainRequest" } } }, "required": true }, "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CqlExplainResponse" } } } } } } }, "/api/v1/demo/generate-results": { "post": { "tags": [ "measure-seeding-controller" ], "operationId": "generateDemoResults", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DemoResultsRequest" } } }, "required": true }, "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DemoResultsResponse" } } } } } } }, "/api/patients/{patientId}/recalculate-risk": { "post": { "tags": [ "risk-assessment-controller" ], "operationId": "recalculateRisk", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "patientId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RiskAssessmentDTO" } } } } } } }, "/templates/sample-data/{templateId}": { "get": { "tags": [ "template-preview-controller" ], "operationId": "getSampleDataStructure", "parameters": [ { "name": "templateId", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } } } } }, "/templates/list": { "get": { "tags": [ "template-preview-controller" ], "operationId": "listTemplates", "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } } } } }, "/templates/exists/{templateId}": { "get": { "tags": [ "template-preview-controller" ], "operationId": "checkTemplateExists", "parameters": [ { "name": "templateId", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } } } } }, "/quality-measure/score": { "get": { "tags": [ "quality-measure-controller" ], "operationId": "getQualityScore", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "patient", "in": "query", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QualityScore" } } } } } } }, "/quality-measure/results": { "get": { "tags": [ "quality-measure-controller" ], "operationId": "getPatientResults", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "patient", "in": "query", "required": false, "schema": { "type": "string", "format": "uuid" } }, { "name": "page", "in": "query", "required": false, "schema": { "minimum": 0, "type": "integer", "format": "int32", "default": 0 } }, { "name": "size", "in": "query", "required": false, "schema": { "minimum": 0, "type": "integer", "format": "int32", "default": 20 } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/QualityMeasureResultDTO" } } } } } } } }, "/quality-measure/reports": { "get": { "tags": [ "quality-measure-controller" ], "operationId": "getSavedReports", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "type", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/SavedReportEntity" } } } } } } } }, "/quality-measure/reports/{reportId}": { "get": { "tags": [ "quality-measure-controller" ], "operationId": "getSavedReport", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "reportId", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SavedReportEntity" } } } } } }, "delete": { "tags": [ "quality-measure-controller" ], "operationId": "deleteSavedReport", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "reportId", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK" } } } }, "/quality-measure/reports/{reportId}/export/excel": { "get": { "tags": [ "quality-measure-controller" ], "operationId": "exportReportToExcel", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "reportId", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "type": "string", "format": "byte" } } } } } } }, "/quality-measure/reports/{reportId}/export/csv": { "get": { "tags": [ "quality-measure-controller" ], "operationId": "exportReportToCsv", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "reportId", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "text/csv": { "schema": { "type": "string", "format": "byte" } } } } } } }, "/quality-measure/report/population": { "get": { "tags": [ "quality-measure-controller" ], "operationId": "getPopulationQualityReport", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "year", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32" } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PopulationQualityReport" } } } } } } }, "/quality-measure/report/patient": { "get": { "tags": [ "quality-measure-controller" ], "operationId": "getPatientQualityReport", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "patient", "in": "query", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QualityReport" } } } } } } }, "/quality-measure/population/jobs": { "get": { "tags": [ "quality-measure-controller" ], "operationId": "getAllJobs", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "additionalProperties": { "type": "object" } } } } } } } } }, "/quality-measure/population/jobs/{jobId}": { "get": { "tags": [ "quality-measure-controller" ], "operationId": "getJobStatus", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "jobId", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/quality-measure/patients/{patientId}/health-score": { "get": { "tags": [ "health-score-controller" ], "operationId": "getCurrentHealthScore", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "patientId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HealthScoreDTO" } } } } } } }, "/quality-measure/patients/{patientId}/health-score/history": { "get": { "tags": [ "health-score-controller" ], "operationId": "getHealthScoreHistory", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "patientId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "limit", "in": "query", "required": false, "schema": { "minimum": 0, "type": "integer", "format": "int32", "default": 50 } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/HealthScoreDTO" } } } } } } } }, "/quality-measure/patients/health-scores/significant-changes": { "get": { "tags": [ "health-score-controller" ], "operationId": "getSignificantChanges", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "days", "in": "query", "required": false, "schema": { "minimum": 0, "type": "integer", "format": "int32", "default": 7 } }, { "name": "page", "in": "query", "required": false, "schema": { "minimum": 0, "type": "integer", "format": "int32", "default": 0 } }, { "name": "size", "in": "query", "required": false, "schema": { "minimum": 0, "type": "integer", "format": "int32", "default": 20 } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PageHealthScoreDTO" } } } } } } }, "/quality-measure/patients/health-scores/at-risk": { "get": { "tags": [ "health-score-controller" ], "operationId": "getAtRiskPatients", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "threshold", "in": "query", "required": false, "schema": { "type": "number", "format": "double", "default": 60 } }, { "name": "page", "in": "query", "required": false, "schema": { "minimum": 0, "type": "integer", "format": "int32", "default": 0 } }, { "name": "size", "in": "query", "required": false, "schema": { "minimum": 0, "type": "integer", "format": "int32", "default": 20 } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PageHealthScoreDTO" } } } } } } }, "/quality-measure/_health": { "get": { "tags": [ "quality-measure-controller" ], "operationId": "healthCheck", "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": { "type": "string" } } } } } } } }, "/patient-health/risk-stratification/{patientId}": { "get": { "tags": [ "patient-health-controller" ], "operationId": "getRiskStratification", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "patientId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RiskAssessmentDTO" } } } } } } }, "/patient-health/overview/{patientId}": { "get": { "tags": [ "patient-health-controller" ], "operationId": "getPatientHealthOverview", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "patientId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PatientHealthOverviewDTO" } } } } } } }, "/patient-health/mental-health/assessments/{patientId}": { "get": { "tags": [ "patient-health-controller" ], "operationId": "getPatientAssessments", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "patientId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 10 } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 0 } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/MentalHealthAssessmentDTO" } } } } } } } }, "/patient-health/mental-health/assessments/{patientId}/trend": { "get": { "tags": [ "patient-health-controller" ], "operationId": "getAssessmentTrend", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "patientId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "type", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "startDate", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "endDate", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AssessmentTrend" } } } } } } }, "/patient-health/health-score/{patientId}": { "get": { "tags": [ "patient-health-controller" ], "operationId": "getHealthScore", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "patientId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HealthScoreDTO" } } } } } } }, "/patient-health/care-gaps/{patientId}": { "get": { "tags": [ "patient-health-controller" ], "operationId": "getPatientCareGaps", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "patientId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "category", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/CareGapDTO" } } } } } } } }, "/measures/local": { "get": { "tags": [ "measure-registry-controller" ], "operationId": "getLocalMeasures", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/MeasureMetadata" } } } } } } } }, "/cds/rules": { "get": { "tags": [ "cds-controller" ], "operationId": "getRules", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "activeOnly", "in": "query", "required": false, "schema": { "type": "boolean", "default": true } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/CdsRuleDTO" } } } } } } } }, "/cds/rules/{ruleCode}": { "get": { "tags": [ "cds-controller" ], "operationId": "getRuleByCode", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "ruleCode", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CdsRuleDTO" } } } } } } }, "/cds/rules/category/{category}": { "get": { "tags": [ "cds-controller" ], "operationId": "getRulesByCategory", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "category", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/CdsRuleDTO" } } } } } } } }, "/cds/recommendations/{patientId}": { "get": { "tags": [ "cds-controller" ], "operationId": "getRecommendations", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "patientId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/CdsRecommendationDTO" } } } } } } } }, "/cds/recommendations/{patientId}/overdue": { "get": { "tags": [ "cds-controller" ], "operationId": "getOverdueRecommendations", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "patientId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/CdsRecommendationDTO" } } } } } } } }, "/cds/recommendations/{patientId}/count": { "get": { "tags": [ "cds-controller" ], "operationId": "getRecommendationCount", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "patientId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RecommendationCountResponse" } } } } } } }, "/api/v1/results/{resultId}/signature": { "get": { "tags": [ "Result Signing" ], "summary": "Get result signature", "description": "Retrieve signature details for a specific result", "operationId": "getSignature", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "resultId", "in": "path", "description": "Result UUID", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "404": { "description": "Result not signed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResultSignatureEntity" } } } }, "200": { "description": "Signature found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResultSignatureEntity" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResultSignatureEntity" } } } } } } }, "/api/v1/results/signatures": { "get": { "tags": [ "Result Signing" ], "summary": "Get signatures by user", "description": "Retrieve all signatures made by a specific user within a date range", "operationId": "getSignaturesByUser", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "userId", "in": "query", "description": "User ID to filter by", "required": true, "schema": { "type": "string" } }, { "name": "from", "in": "query", "description": "Start date/time (ISO-8601)", "required": true, "schema": { "type": "string", "format": "date-time" } }, { "name": "to", "in": "query", "description": "End date/time (ISO-8601)", "required": true, "schema": { "type": "string", "format": "date-time" } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/ResultSignatureEntity" } } } } } } } }, "/api/v1/providers/{providerId}/performance": { "get": { "tags": [ "Provider Performance" ], "summary": "Get provider performance metrics", "description": "Returns performance metrics for a provider including compliance rates, practice averages, historical trends, and percentile rankings. Practice averages are anonymized to protect individual provider data.", "operationId": "getProviderPerformance", "parameters": [ { "name": "providerId", "in": "path", "description": "Provider's unique identifier", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "X-Tenant-ID", "in": "header", "description": "Tenant identifier", "required": true, "schema": { "type": "string" } }, { "name": "measureIds", "in": "query", "description": "Specific measure IDs to include (optional)", "required": false, "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "period", "in": "query", "description": "Time period: YTD, LAST_12_MONTHS, LAST_QUARTER", "required": false, "schema": { "type": "string", "default": "YTD" } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ProviderPerformanceResponse" } } } } } } }, "/api/v1/providers/performance/summary": { "get": { "tags": [ "Provider Performance" ], "summary": "Get practice-wide performance summary", "description": "Returns aggregated performance metrics for all providers in the practice. Admin/Analyst only. Individual provider rates are anonymized in rankings.", "operationId": "getPracticePerformanceSummary", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "description": "Tenant identifier", "required": true, "schema": { "type": "string" } }, { "name": "measureIds", "in": "query", "description": "Specific measure IDs to include (optional)", "required": false, "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "period", "in": "query", "description": "Time period: YTD, LAST_12_MONTHS, LAST_QUARTER", "required": false, "schema": { "type": "string", "default": "YTD" } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/ProviderPerformanceResponse" } } } } } } } }, "/api/v1/providers/me/performance": { "get": { "tags": [ "Provider Performance" ], "summary": "Get current provider's performance metrics", "description": "Returns performance metrics for the currently authenticated provider. This endpoint uses the user's associated provider ID.", "operationId": "getMyPerformance", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "description": "Tenant identifier", "required": true, "schema": { "type": "string" } }, { "name": "X-Auth-User-Id", "in": "header", "description": "Authenticated user's ID", "required": true, "schema": { "type": "string" } }, { "name": "measureIds", "in": "query", "description": "Specific measure IDs to include (optional)", "required": false, "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "period", "in": "query", "description": "Time period: YTD, LAST_12_MONTHS, LAST_QUARTER", "required": false, "schema": { "type": "string", "default": "YTD" } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ProviderPerformanceResponse" } } } } } } }, "/api/v1/measures": { "get": { "tags": [ "measure-seeding-controller" ], "operationId": "getMeasures", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/MeasureDTO" } } } } } } } }, "/api/v1/measures/{measureId}/versions/{version}": { "get": { "tags": [ "measure-version-controller" ], "operationId": "getVersion", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "measureId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "version", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MeasureVersionDTO" } } } } } } }, "/api/v1/measures/{measureId}/versions/summaries": { "get": { "tags": [ "measure-version-controller" ], "operationId": "getVersionSummaries", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "measureId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "additionalProperties": { "type": "object" } } } } } } } } }, "/api/v1/measures/{measureId}/versions/published": { "get": { "tags": [ "measure-version-controller" ], "operationId": "getPublishedVersions", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "measureId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/MeasureVersionDTO" } } } } } } } }, "/api/v1/measures/{measureId}/versions/current": { "get": { "tags": [ "measure-version-controller" ], "operationId": "getCurrentVersion", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "measureId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MeasureVersionDTO" } } } } } } }, "/api/v1/measures/{measureId}/versions/count": { "get": { "tags": [ "measure-version-controller" ], "operationId": "getVersionCount", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "measureId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": { "type": "integer", "format": "int64" } } } } } } } }, "/api/v1/measures/{measureId}/versions/compare": { "get": { "tags": [ "measure-version-controller" ], "operationId": "compareVersions", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "measureId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "v1", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "v2", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VersionComparisonDTO" } } } } } } }, "/api/v1/measures/versions/by-user/{userId}": { "get": { "tags": [ "measure-version-controller" ], "operationId": "getVersionsByUser", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "userId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/MeasureVersionDTO" } } } } } } } }, "/api/v1/measures/versions/audit": { "get": { "tags": [ "measure-version-controller" ], "operationId": "getAllVersions", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "page", "in": "query", "required": false, "schema": { "minimum": 0, "type": "integer", "format": "int32", "default": 0 } }, { "name": "size", "in": "query", "required": false, "schema": { "minimum": 0, "type": "integer", "format": "int32", "default": 50 } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PageMeasureVersionDTO" } } } } } } }, "/api/v1/measures/ai/templates": { "get": { "tags": [ "ai-measure-controller" ], "operationId": "getTemplates", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "category", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/CqlTemplate" } } } } } } } }, "/api/v1/measures/ai/templates/{templateId}": { "get": { "tags": [ "ai-measure-controller" ], "operationId": "getTemplate", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "templateId", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CqlTemplateDetail" } } } } } } }, "/api/risk/population-stats": { "get": { "tags": [ "risk-assessment-controller" ], "operationId": "getPopulationStats", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PopulationRiskStats" } } } } } } }, "/api/patients/{patientId}/risk-history": { "get": { "tags": [ "risk-assessment-controller" ], "operationId": "getRiskHistory", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "patientId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/RiskAssessmentDTO" } } } } } } } }, "/api/patients/{patientId}/risk-by-category/{category}": { "get": { "tags": [ "risk-assessment-controller" ], "operationId": "getRiskByCategory", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "patientId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "category", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RiskAssessmentDTO" } } } } } } }, "/api/patients/{patientId}/risk-assessment": { "get": { "tags": [ "risk-assessment-controller" ], "operationId": "getCurrentRiskAssessment", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "patientId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RiskAssessmentDTO" } } } } } } }, "/actuator": { "get": { "tags": [ "Actuator" ], "summary": "Actuator root web endpoint", "operationId": "links", "responses": { "200": { "description": "OK", "content": { "application/vnd.spring-boot.actuator.v3+json": { "schema": { "type": "object", "additionalProperties": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/Link" } } } }, "application/json": { "schema": { "type": "object", "additionalProperties": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/Link" } } } }, "application/vnd.spring-boot.actuator.v2+json": { "schema": { "type": "object", "additionalProperties": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/Link" } } } } } } } } }, "/actuator/prometheus": { "get": { "tags": [ "Actuator" ], "summary": "Actuator web endpoint 'prometheus'", "operationId": "prometheus", "responses": { "200": { "description": "OK", "content": { "text/plain;version=0.0.4;charset=utf-8": { "schema": { "type": "object" } }, "application/vnd.google.protobuf;proto=io.prometheus.client.MetricFamily;encoding=delimited": { "schema": { "type": "object" } }, "application/openmetrics-text;version=1.0.0;charset=utf-8": { "schema": { "type": "object" } } } } } } }, "/actuator/metrics": { "get": { "tags": [ "Actuator" ], "summary": "Actuator web endpoint 'metrics'", "operationId": "metrics", "responses": { "200": { "description": "OK", "content": { "application/vnd.spring-boot.actuator.v3+json": { "schema": { "type": "object" } }, "application/json": { "schema": { "type": "object" } }, "application/vnd.spring-boot.actuator.v2+json": { "schema": { "type": "object" } } } } } } }, "/actuator/metrics/{requiredMetricName}": { "get": { "tags": [ "Actuator" ], "summary": "Actuator web endpoint 'metrics-requiredMetricName'", "operationId": "metrics-requiredMetricName", "parameters": [ { "name": "requiredMetricName", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/vnd.spring-boot.actuator.v3+json": { "schema": { "type": "object" } }, "application/json": { "schema": { "type": "object" } }, "application/vnd.spring-boot.actuator.v2+json": { "schema": { "type": "object" } } } } } } }, "/actuator/info": { "get": { "tags": [ "Actuator" ], "summary": "Actuator web endpoint 'info'", "operationId": "info", "responses": { "200": { "description": "OK", "content": { "application/vnd.spring-boot.actuator.v3+json": { "schema": { "type": "object" } }, "application/json": { "schema": { "type": "object" } }, "application/vnd.spring-boot.actuator.v2+json": { "schema": { "type": "object" } } } } } } }, "/actuator/health": { "get": { "tags": [ "Actuator" ], "summary": "Actuator web endpoint 'health'", "operationId": "health", "responses": { "200": { "description": "OK", "content": { "application/vnd.spring-boot.actuator.v3+json": { "schema": { "type": "object" } }, "application/json": { "schema": { "type": "object" } }, "application/vnd.spring-boot.actuator.v2+json": { "schema": { "type": "object" } } } } } } }, "/actuator/health/**": { "get": { "tags": [ "Actuator" ], "summary": "Actuator web endpoint 'health-path'", "operationId": "health-path", "responses": { "200": { "description": "OK", "content": { "application/vnd.spring-boot.actuator.v3+json": { "schema": { "type": "object" } }, "application/json": { "schema": { "type": "object" } }, "application/vnd.spring-boot.actuator.v2+json": { "schema": { "type": "object" } } } } } } }, "/quality-measure/custom-measures/batch-delete": { "delete": { "tags": [ "Custom Measures" ], "summary": "Batch delete custom measures", "description": "Soft delete multiple custom measures at once. Measures with evaluations require force=true.", "operationId": "batchDelete", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BatchDeleteRequest" } } }, "required": true }, "responses": { "503": { "description": "Service Unavailable", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "400": { "description": "Bad Request", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "500": { "description": "Internal Server Error", "content": { "*/*": { "schema": { "type": "object", "additionalProperties": { "type": "object" } } } } }, "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/BatchDeleteResponse" } } } } } } }, "/_health": { "get": { "tags": [ "Quality Measure Evaluation" ], "summary": "Quality measure service health check", "operationId": "getJobStatus", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/api/v1/demo/evaluate-cql": { "post": { "tags": [ "MeasureSeeding" ], "summary": "evaluateWithCql", "operationId": "evaluateWithCql", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/api/v1/measures/{measureId}/versions/{version}/retire": { "post": { "tags": [ "Measure Versioning" ], "summary": "Retire a measure version", "operationId": "retireVersion", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [ { "name": "measureId", "in": "path", "required": true, "description": "Path parameter measureId", "schema": { "type": "string" } }, { "name": "version", "in": "path", "required": true, "description": "Path parameter version", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/calculate": { "post": { "tags": [ "Quality Measure Evaluation" ], "summary": "Calculate quality measure for patient", "operationId": "calculateMeasure", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/custom-measures/batch-delete": { "post": { "tags": [ "Custom Measures" ], "summary": "Batch publish draft measures", "operationId": "batchDelete", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/custom-measures/batch-publish": { "post": { "tags": [ "Custom Measures" ], "summary": "Delete a custom measure (soft delete)", "operationId": "batchPublish", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/custom-measures/evaluate-patient": { "post": { "tags": [ "Custom Measures" ], "summary": "Test a custom measure against sample patients", "operationId": "evaluatePatient", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/custom-measures/{id}": { "get": { "tags": [ "Custom Measures" ], "summary": "getById", "operationId": "getById", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Path parameter id", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } }, "put": { "tags": [ "Custom Measures" ], "summary": "updateDraft", "operationId": "updateDraft", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Path parameter id", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } }, "delete": { "tags": [ "Custom Measures" ], "summary": "delete", "operationId": "delete", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Path parameter id", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/custom-measures/{id}/clone": { "post": { "tags": [ "Custom Measures" ], "summary": "Publish a single custom measure", "operationId": "cloneMeasure", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Path parameter id", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/custom-measures/{id}/cql": { "put": { "tags": [ "Custom Measures" ], "summary": "Batch delete custom measures", "operationId": "updateCql", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Path parameter id", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/custom-measures/{id}/publish": { "post": { "tags": [ "Custom Measures" ], "summary": "Update value sets for a custom measure", "operationId": "publish", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Path parameter id", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/custom-measures/{id}/test": { "post": { "tags": [ "Custom Measures" ], "summary": "Clone a custom measure as a new draft", "operationId": "testMeasure", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Path parameter id", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/custom-measures/{id}/value-sets": { "put": { "tags": [ "Custom Measures" ], "summary": "Update CQL text for a custom measure", "operationId": "updateValueSets", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Path parameter id", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/evaluation-presets/default": { "get": { "tags": [ "EvaluationPreset" ], "summary": "getDefaultPreset", "operationId": "getDefaultPreset", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } }, "put": { "tags": [ "EvaluationPreset" ], "summary": "saveDefaultPreset", "operationId": "saveDefaultPreset", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } }, "delete": { "tags": [ "EvaluationPreset" ], "summary": "clearDefaultPreset", "operationId": "clearDefaultPreset", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/measure-assignments/{assignmentId}": { "delete": { "tags": [ "MeasureAssignment" ], "summary": "deactivateAssignment", "operationId": "deactivateAssignment", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [ { "name": "assignmentId", "in": "path", "required": true, "description": "Path parameter assignmentId", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/measure-assignments/{assignmentId}/dates": { "put": { "tags": [ "MeasureAssignment" ], "summary": "updateEffectiveDates", "operationId": "updateEffectiveDates", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [ { "name": "assignmentId", "in": "path", "required": true, "description": "Path parameter assignmentId", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/measure-overrides/due-for-review": { "get": { "tags": [ "MeasureOverride" ], "summary": "get__measure-overrides_due-for-review", "operationId": "get__measure-overrides_due-for-review", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/measure-overrides/pending-approval": { "get": { "tags": [ "MeasureOverride" ], "summary": "get__measure-overrides_pending-approval", "operationId": "get__measure-overrides_pending-approval", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/measure-overrides/{overrideId}": { "delete": { "tags": [ "MeasureOverride" ], "summary": "deactivateOverride", "operationId": "deactivateOverride", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [ { "name": "overrideId", "in": "path", "required": true, "description": "Path parameter overrideId", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/measure-overrides/{overrideId}/approve": { "post": { "tags": [ "MeasureOverride" ], "summary": "approveOverride", "operationId": "approveOverride", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [ { "name": "overrideId", "in": "path", "required": true, "description": "Path parameter overrideId", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/measure-overrides/{overrideId}/review": { "post": { "tags": [ "MeasureOverride" ], "summary": "markReviewed", "operationId": "markReviewed", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [ { "name": "overrideId", "in": "path", "required": true, "description": "Path parameter overrideId", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/patient-health/care-gaps/trends": { "get": { "tags": [ "PatientHealth" ], "summary": "addressCareGap", "operationId": "addressCareGap", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/patients/health-scores/at-risk": { "get": { "tags": [ "HealthScore" ], "summary": "get__patients_health-scores_at-risk", "operationId": "get__patients_health-scores_at-risk", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/patients/health-scores/significant-changes": { "get": { "tags": [ "HealthScore" ], "summary": "get__patients_health-scores_significant-changes", "operationId": "get__patients_health-scores_significant-changes", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/patients/{patientId}/health-score": { "get": { "tags": [ "HealthScore" ], "summary": "getCurrentHealthScore", "operationId": "getCurrentHealthScore", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [ { "name": "patientId", "in": "path", "required": true, "description": "Path parameter patientId", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/patients/{patientId}/health-score/history": { "get": { "tags": [ "HealthScore" ], "summary": "get__patients_{patientId}_health-score_history", "operationId": "get__patients_{patientId}_health-score_history", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [ { "name": "patientId", "in": "path", "required": true, "description": "Path parameter patientId", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/patients/{patientId}/measure-assignments": { "get": { "tags": [ "MeasureAssignment" ], "summary": "assignMeasure", "operationId": "assignMeasure", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [ { "name": "patientId", "in": "path", "required": true, "description": "Path parameter patientId", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } }, "post": { "tags": [ "MeasureAssignment" ], "summary": "assignMeasure", "operationId": "assignMeasure", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [ { "name": "patientId", "in": "path", "required": true, "description": "Path parameter patientId", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/patients/{patientId}/measure-assignments/count": { "get": { "tags": [ "MeasureAssignment" ], "summary": "countAssignments", "operationId": "countAssignments", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [ { "name": "patientId", "in": "path", "required": true, "description": "Path parameter patientId", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/patients/{patientId}/measure-overrides": { "get": { "tags": [ "MeasureOverride" ], "summary": "createOverride", "operationId": "createOverride", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [ { "name": "patientId", "in": "path", "required": true, "description": "Path parameter patientId", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } }, "post": { "tags": [ "MeasureOverride" ], "summary": "createOverride", "operationId": "createOverride", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [ { "name": "patientId", "in": "path", "required": true, "description": "Path parameter patientId", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/patients/{patientId}/measures/{measureId}/resolve-overrides": { "post": { "tags": [ "MeasureOverride" ], "summary": "post__patients_{patientId}_measures_{measureId}_resolve-overrides", "operationId": "post__patients_{patientId}_measures_{measureId}_resolve-overrides", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [ { "name": "patientId", "in": "path", "required": true, "description": "Path parameter patientId", "schema": { "type": "string" } }, { "name": "measureId", "in": "path", "required": true, "description": "Path parameter measureId", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/population/calculate": { "post": { "tags": [ "Quality Measure Evaluation" ], "summary": "Start batch population quality measure calculation", "operationId": "getJobStatus", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/population/jobs": { "get": { "tags": [ "Quality Measure Evaluation" ], "summary": "List all batch calculation jobs", "operationId": "exportJobResultsToCsv", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/population/jobs/{jobId}": { "get": { "tags": [ "Quality Measure Evaluation" ], "summary": "Get batch calculation job status", "operationId": "getJobStatus", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [ { "name": "jobId", "in": "path", "required": true, "description": "Path parameter jobId", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/population/jobs/{jobId}/cancel": { "put": { "tags": [ "Quality Measure Evaluation" ], "summary": "Cancel a running batch calculation job", "operationId": "exportJobResultsToCsv", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [ { "name": "jobId", "in": "path", "required": true, "description": "Path parameter jobId", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/population/jobs/{jobId}/export/csv": { "get": { "tags": [ "Quality Measure Evaluation" ], "summary": "Export batch calculation results to CSV", "operationId": "exportJobResultsToCsv", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [ { "name": "jobId", "in": "path", "required": true, "description": "Path parameter jobId", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/report/patient": { "get": { "tags": [ "Quality Measure Evaluation" ], "summary": "Get patient quality report", "operationId": "getPatientQualityReport", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/report/patient/save": { "post": { "tags": [ "Quality Measure Evaluation" ], "summary": "Save patient quality report", "operationId": "savePatientReport", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/report/population": { "get": { "tags": [ "Quality Measure Evaluation" ], "summary": "Get population quality report", "operationId": "getPopulationQualityReport", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/report/population/save": { "post": { "tags": [ "Quality Measure Evaluation" ], "summary": "Save population quality report", "operationId": "savePopulationReport", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/reports": { "get": { "tags": [ "Quality Measure Evaluation" ], "summary": "List saved quality reports", "operationId": "getSavedReport", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/reports/{reportId}": { "get": { "tags": [ "Quality Measure Evaluation" ], "summary": "Get saved quality report by ID", "operationId": "getSavedReport", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [ { "name": "reportId", "in": "path", "required": true, "description": "Path parameter reportId", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } }, "delete": { "tags": [ "Quality Measure Evaluation" ], "summary": "Delete a saved quality report", "operationId": "deleteSavedReport", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [ { "name": "reportId", "in": "path", "required": true, "description": "Path parameter reportId", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/reports/{reportId}/export/csv": { "get": { "tags": [ "Quality Measure Evaluation" ], "summary": "Export saved report to CSV", "operationId": "exportReportToCsv", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [ { "name": "reportId", "in": "path", "required": true, "description": "Path parameter reportId", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/reports/{reportId}/export/excel": { "get": { "tags": [ "Quality Measure Evaluation" ], "summary": "Export saved report to Excel", "operationId": "exportReportToExcel", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [ { "name": "reportId", "in": "path", "required": true, "description": "Path parameter reportId", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/results": { "get": { "tags": [ "Quality Measure Evaluation" ], "summary": "Get quality measure results", "operationId": "getQualityScore", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/score": { "get": { "tags": [ "Quality Measure Evaluation" ], "summary": "Get patient quality score", "operationId": "getQualityScore", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/cds-services": { "get": { "tags": [ "CdsHooks" ], "summary": "discoverServices", "operationId": "discoverServices", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/cds-services/order-select": { "post": { "tags": [ "CdsHooks" ], "summary": "orderSelect", "operationId": "orderSelect", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/cds-services/patient-view": { "post": { "tags": [ "CdsHooks" ], "summary": "patientView", "operationId": "patientView", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/regional-cohorts": { "get": { "tags": [ "Regional Cohorts" ], "summary": "List cohort definitions for a tenant", "operationId": "listRegionalCohortDefinitions", "description": "Returns the cohort definitions currently owned by the tenant.", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Cohort definitions for the tenant.", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/RegionalCohortDefinitionResponse" } } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } }, "post": { "tags": [ "Regional Cohorts" ], "summary": "Create a cohort definition", "operationId": "createRegionalCohortDefinition", "description": "Creates a new regional cohort definition for the tenant.", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "X-Auth-Username", "in": "header", "required": false, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RegionalCohortDefinitionRequest" } } } }, "responses": { "200": { "description": "Created cohort definition.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RegionalCohortDefinitionResponse" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/regional-cohorts/capabilities": { "get": { "tags": [ "Regional Cohorts" ], "summary": "List supported cohort clause capabilities", "operationId": "listRegionalCohortCapabilities", "description": "Returns the supported field, operator, and evidence-profile combinations for regional cohort clauses.", "parameters": [], "responses": { "200": { "description": "Supported regional cohort clause capabilities.", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/RegionalCohortCapabilityResponse" } } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/regional-cohorts/{definitionId}": { "get": { "tags": [ "Regional Cohorts" ], "summary": "Get a single cohort definition", "operationId": "getRegionalCohortDefinition", "description": "Returns one cohort definition for the tenant.", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "definitionId", "in": "path", "required": true, "description": "Path parameter definitionId", "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Requested cohort definition.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RegionalCohortDefinitionResponse" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } }, "put": { "tags": [ "Regional Cohorts" ], "summary": "Update a cohort definition", "operationId": "updateRegionalCohortDefinition", "description": "Updates an existing regional cohort definition for the tenant.", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "X-Auth-Username", "in": "header", "required": false, "schema": { "type": "string" } }, { "name": "definitionId", "in": "path", "required": true, "description": "Path parameter definitionId", "schema": { "type": "string", "format": "uuid" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RegionalCohortDefinitionRequest" } } } }, "responses": { "200": { "description": "Updated cohort definition.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RegionalCohortDefinitionResponse" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/regional-cohorts/{definitionId}/archive": { "post": { "tags": [ "Regional Cohorts" ], "summary": "Archive a cohort definition", "operationId": "archiveRegionalCohortDefinition", "description": "Archives a cohort definition and returns the archived record.", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "X-Auth-Username", "in": "header", "required": false, "schema": { "type": "string" } }, { "name": "definitionId", "in": "path", "required": true, "description": "Path parameter definitionId", "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Archive a cohort definition", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RegionalCohortDefinitionResponse" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/regional-cohorts/{definitionId}/execute": { "post": { "tags": [ "Regional Cohorts" ], "summary": "Execute cohort membership evaluation", "operationId": "executeRegionalCohortDefinition", "description": "Executes the cohort membership evaluation and returns a run summary.", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "X-Auth-Username", "in": "header", "required": false, "schema": { "type": "string" } }, { "name": "definitionId", "in": "path", "required": true, "description": "Path parameter definitionId", "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Execution summary for the cohort run.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RegionalCohortEvaluationResponse" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/regional-cohorts/{definitionId}/memberships": { "get": { "tags": [ "Regional Cohorts" ], "summary": "List matched cohort members from an execution run", "operationId": "listRegionalCohortMemberships", "description": "Returns paged matched members for a cohort definition, optionally scoped to a specific execution run.", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "definitionId", "in": "path", "required": true, "description": "Path parameter definitionId", "schema": { "type": "string", "format": "uuid" } }, { "name": "runId", "in": "query", "required": false, "schema": { "type": "string", "format": "uuid" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 0 } }, { "name": "size", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 25 } } ], "responses": { "200": { "description": "Paged matched cohort memberships.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RegionalCohortMembershipPage" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/regional-cohorts/{definitionId}/preview": { "post": { "tags": [ "Regional Cohorts" ], "summary": "Preview cohort membership", "operationId": "previewRegionalCohortDefinition", "description": "Previews the cohort membership and returns a summary with sample members.", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "definitionId", "in": "path", "required": true, "description": "Path parameter definitionId", "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Preview summary for the cohort definition.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RegionalCohortEvaluationResponse" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/regional-cohorts/{definitionId}/publish": { "post": { "tags": [ "Regional Cohorts" ], "summary": "Publish a cohort definition", "operationId": "publishRegionalCohortDefinition", "description": "Publishes a cohort definition and returns the published record.", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "X-Auth-Username", "in": "header", "required": false, "schema": { "type": "string" } }, { "name": "definitionId", "in": "path", "required": true, "description": "Path parameter definitionId", "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Publish a cohort definition", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RegionalCohortDefinitionResponse" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/regional-cohorts/{definitionId}/delivery-summary": { "get": { "tags": [ "Regional Cohorts" ], "summary": "Get regional cohort delivery summary", "operationId": "getRegionalCohortDeliverySummary", "description": "Returns delivery and synchronization summary details for the latest regional cohort run.", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "definitionId", "in": "path", "required": true, "description": "Path parameter definitionId", "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Delivery summary for the cohort definition." }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/regional-cohorts/{definitionId}/runs": { "get": { "tags": [ "Regional Cohorts" ], "summary": "List execution runs for a cohort definition", "operationId": "listRegionalCohortRuns", "description": "Returns execution runs for a cohort definition.", "parameters": [ { "name": "X-Tenant-ID", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "definitionId", "in": "path", "required": true, "description": "Path parameter definitionId", "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Execution runs for the cohort definition.", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/RegionalCohortRunResponse" } } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/regional-cohorts/{definitionId}/delivery-runs": { "get": { "tags": [ "Regional Cohorts" ], "summary": "List delivery target statuses for a cohort definition", "operationId": "get__regional-cohorts_{definitionId}_delivery-runs", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [ { "name": "definitionId", "in": "path", "required": true, "description": "Path parameter definitionId", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/regional-cohorts/{definitionId}/delivery-targets": { "get": { "tags": [ "Regional Cohorts" ], "summary": "Get delivery summary for a cohort definition", "operationId": "get__regional-cohorts_{definitionId}_delivery-targets", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [ { "name": "definitionId", "in": "path", "required": true, "description": "Path parameter definitionId", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/custom-measures/cql/preview": { "post": { "tags": [ "Custom Measures" ], "summary": "Evaluate CQL text against a specific patient", "operationId": "previewCql", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/patient-health/recommendations/dashboard": { "get": { "tags": [ "PatientHealth" ], "summary": "getRecommendationStats", "operationId": "getRecommendationStats", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/patient-health/recommendations/filter": { "get": { "tags": [ "PatientHealth" ], "summary": "get__patient-health_recommendations_filter", "operationId": "get__patient-health_recommendations_filter", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/patient-health/recommendations/high-priority": { "get": { "tags": [ "PatientHealth" ], "summary": "get__patient-health_recommendations_high-priority", "operationId": "get__patient-health_recommendations_high-priority", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } }, "/patient-health/recommendations/stats": { "get": { "tags": [ "PatientHealth" ], "summary": "getRecommendationStats", "operationId": "getRecommendationStats", "description": "Stub operation added by scripts/docs/refresh_quality_measure_openapi.py from static controller-source analysis. Request/response schemas TBD \u2014 enrich via runtime springdoc refresh.", "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" } } } } }, "components": { "schemas": { "RegionalCohortDefinitionRequest": { "required": [ "name", "rootGroup" ], "type": "object", "properties": { "name": { "type": "string" }, "description": { "type": "string" }, "rootGroup": { "$ref": "#/components/schemas/RegionalCohortCriteriaGroup" } } }, "RegionalCohortDefinitionResponse": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "tenantId": { "type": "string" }, "name": { "type": "string" }, "description": { "type": "string" }, "status": { "$ref": "#/components/schemas/RegionalCohortStatus" }, "definitionVersion": { "type": "integer", "format": "int32" }, "rootGroup": { "$ref": "#/components/schemas/RegionalCohortCriteriaGroup" }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" }, "publishedAt": { "type": "string", "format": "date-time" }, "archivedAt": { "type": "string", "format": "date-time" } } }, "RegionalCohortCriteriaGroup": { "type": "object", "properties": { "operator": { "$ref": "#/components/schemas/RegionalCohortGroupOperator" }, "clauses": { "type": "array", "items": { "$ref": "#/components/schemas/RegionalCohortClause" } }, "groups": { "type": "array", "items": { "$ref": "#/components/schemas/RegionalCohortCriteriaGroup" } } } }, "RegionalCohortClause": { "type": "object", "properties": { "id": { "type": "string" }, "field": { "$ref": "#/components/schemas/RegionalCohortField" }, "operator": { "$ref": "#/components/schemas/RegionalCohortClauseOperator" }, "evidenceProfile": { "$ref": "#/components/schemas/RegionalCohortEvidenceProfile" }, "value": { "type": "string" }, "values": { "type": "array", "items": { "type": "string" } }, "referenceCode": { "type": "string" }, "note": { "type": "string" } } }, "RegionalCohortCapabilityResponse": { "type": "object", "properties": { "field": { "$ref": "#/components/schemas/RegionalCohortField" }, "label": { "type": "string" }, "supportedOperators": { "type": "array", "items": { "$ref": "#/components/schemas/RegionalCohortClauseOperator" } }, "supportedEvidenceProfiles": { "type": "array", "items": { "$ref": "#/components/schemas/RegionalCohortEvidenceProfile" } }, "note": { "type": "string" } } }, "RegionalCohortEvaluationResponse": { "type": "object", "properties": { "definitionId": { "type": "string", "format": "uuid" }, "definitionVersion": { "type": "integer", "format": "int32" }, "runId": { "type": "string", "format": "uuid" }, "status": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time" }, "completedAt": { "type": "string", "format": "date-time" }, "totalPatientsEvaluated": { "type": "integer", "format": "int32" }, "matchedPatients": { "type": "integer", "format": "int32" }, "warnings": { "type": "array", "items": { "type": "string" } }, "sampleMembers": { "type": "array", "items": { "$ref": "#/components/schemas/RegionalCohortMembershipSummary" } } } }, "RegionalCohortRunResponse": { "type": "object", "properties": { "runId": { "type": "string", "format": "uuid" }, "definitionVersion": { "type": "integer", "format": "int32" }, "status": { "type": "string" }, "totalPatientsEvaluated": { "type": "integer", "format": "int32" }, "matchedPatients": { "type": "integer", "format": "int32" }, "startedAt": { "type": "string", "format": "date-time" }, "completedAt": { "type": "string", "format": "date-time" } } }, "RegionalCohortMembershipSummary": { "type": "object", "properties": { "patientId": { "type": "string", "format": "uuid" }, "patientName": { "type": "string" }, "gender": { "type": "string" }, "age": { "type": "integer", "format": "int32" }, "city": { "type": "string" }, "state": { "type": "string" }, "inclusionReasons": { "type": "array", "items": { "type": "string" } } } }, "RegionalCohortMembershipPage": { "type": "object", "properties": { "content": { "type": "array", "items": { "$ref": "#/components/schemas/RegionalCohortMembershipSummary" } }, "page": { "$ref": "#/components/schemas/RegionalCohortMembershipPageInfo" } } }, "RegionalCohortMembershipPageInfo": { "type": "object", "properties": { "size": { "type": "integer", "format": "int32" }, "number": { "type": "integer", "format": "int32" }, "totalElements": { "type": "integer", "format": "int64" }, "totalPages": { "type": "integer", "format": "int32" } } }, "RegionalCohortStatus": { "type": "string", "enum": [ "DRAFT", "PUBLISHED", "ARCHIVED" ] }, "RegionalCohortEvidenceProfile": { "type": "string", "enum": [ "NORMALIZED", "EXTRACTED", "RAW" ] }, "RegionalCohortGroupOperator": { "type": "string", "enum": [ "AND", "OR" ] }, "RegionalCohortClauseOperator": { "type": "string", "enum": [ "EQUALS", "IN", "GREATER_THAN", "GREATER_THAN_OR_EQUAL", "LESS_THAN", "LESS_THAN_OR_EQUAL", "CONTAINS_TEXT", "EXISTS" ] }, "RegionalCohortField": { "type": "string", "enum": [ "AGE", "GENDER", "CITY", "STATE", "COUNTRY", "ZIP_CODE", "CONDITION_CODE", "CONDITION_DISPLAY", "PROBLEM_CODE", "PROCEDURE_CODE", "PROCEDURE_DISPLAY", "PROCEDURE_CATEGORY", "ENCOUNTER_CLASS", "ENCOUNTER_TYPE_CODE", "ENCOUNTER_LOCATION", "LAB_CODE", "LAB_VALUE", "DOCUMENT_TYPE_CODE", "DOCUMENT_CATEGORY", "DOCUMENT_TEXT", "REPORTED_TEXT" ] }, "UpdateCustomMeasureRequest": { "type": "object", "properties": { "name": { "type": "string" }, "description": { "type": "string" }, "category": { "type": "string" }, "year": { "type": "integer", "format": "int32" } } }, "CustomMeasureEntity": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "tenantId": { "type": "string" }, "name": { "type": "string" }, "version": { "type": "string" }, "status": { "type": "string" }, "description": { "type": "string" }, "category": { "type": "string" }, "year": { "type": "integer", "format": "int32" }, "cqlText": { "type": "string" }, "valueSets": { "type": "string" }, "createdBy": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" }, "publishedDate": { "type": "string", "format": "date-time" }, "deletedAt": { "type": "string", "format": "date-time" }, "deletedBy": { "type": "string" } } }, "AddressCareGapRequest": { "required": [ "addressedBy", "notes", "status" ], "type": "object", "properties": { "addressedBy": { "type": "string" }, "notes": { "type": "string" }, "status": { "type": "string" } } }, "CareGapDTO": { "type": "object", "properties": { "id": { "type": "string" }, "patientId": { "type": "string", "format": "uuid" }, "category": { "type": "string" }, "gapType": { "type": "string" }, "title": { "type": "string" }, "description": { "type": "string" }, "priority": { "type": "string" }, "status": { "type": "string" }, "qualityMeasure": { "type": "string" }, "recommendation": { "type": "string" }, "evidence": { "type": "string" }, "dueDate": { "type": "string", "format": "date-time" }, "identifiedDate": { "type": "string", "format": "date-time" }, "addressedDate": { "type": "string", "format": "date-time" }, "addressedBy": { "type": "string" }, "addressedNotes": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" } } }, "SavedReportEntity": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "tenantId": { "type": "string" }, "reportType": { "type": "string" }, "reportName": { "type": "string" }, "description": { "type": "string" }, "patientId": { "type": "string", "format": "uuid" }, "year": { "type": "integer", "format": "int32" }, "startDate": { "type": "string", "format": "date" }, "endDate": { "type": "string", "format": "date" }, "reportData": { "type": "string" }, "createdBy": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time" }, "generatedAt": { "type": "string", "format": "date-time" }, "status": { "type": "string" }, "errorMessage": { "type": "string" }, "version": { "type": "integer", "format": "int32" } } }, "CreateCustomMeasureRequest": { "required": [ "name" ], "type": "object", "properties": { "name": { "type": "string" }, "description": { "type": "string" }, "category": { "type": "string" }, "year": { "type": "integer", "format": "int32" }, "createdBy": { "type": "string" } } }, "BatchPublishRequest": { "required": [ "measureIds" ], "type": "object", "properties": { "measureIds": { "type": "array", "items": { "type": "string", "format": "uuid" } } } }, "BatchPublishResponse": { "type": "object", "properties": { "publishedCount": { "type": "integer", "format": "int32" }, "skippedCount": { "type": "integer", "format": "int32" }, "failedCount": { "type": "integer", "format": "int32" }, "errors": { "type": "array", "items": { "type": "string" } } } }, "QualityMeasureResultDTO": { "type": "object", "properties": { "id": { "type": "string", "description": "Unique identifier for this quality measure result", "format": "uuid", "example": "550e8400-e29b-41d4-a716-446655440000" }, "tenantId": { "type": "string", "description": "Tenant identifier", "example": "demo-tenant" }, "patientId": { "type": "string", "description": "Patient identifier", "format": "uuid", "example": "550e8400-e29b-41d4-a716-446655440001" }, "measureId": { "type": "string", "description": "Quality measure identifier (e.g., HEDIS code)", "example": "CDC-A1C9" }, "measureName": { "type": "string", "description": "Human-readable measure name", "example": "Comprehensive Diabetes Care: HbA1c Control (<9.0%)" }, "measureCategory": { "type": "string", "description": "Measure category or program", "example": "HEDIS", "enum": [ "HEDIS", "CMS", "CUSTOM" ] }, "measureYear": { "type": "integer", "description": "Measurement year", "format": "int32", "example": 2024 }, "numeratorCompliant": { "type": "boolean", "description": "Whether patient meets numerator criteria (compliant)", "example": true }, "denominatorElligible": { "type": "boolean", "description": "Whether patient is in the denominator (eligible)", "example": true }, "complianceRate": { "type": "number", "description": "Compliance rate percentage (0.0 to 100.0)", "format": "double", "example": 85.5 }, "score": { "type": "number", "description": "Quality score", "format": "double", "example": 92.3 }, "calculationDate": { "type": "string", "description": "Date when measure was calculated", "format": "date", "example": "2024-11-03" }, "cqlLibrary": { "type": "string", "description": "CQL library used for calculation", "example": "HEDIS_CDC_2024" }, "createdAt": { "type": "string", "description": "Timestamp when record was created", "format": "date-time" }, "createdBy": { "type": "string", "description": "User or system that created this record", "example": "system" }, "version": { "type": "integer", "description": "Version number for optimistic locking", "format": "int32", "example": 1 } }, "description": "Quality measure calculation result for a patient" }, "PredictedOutcomeDTO": { "type": "object", "properties": { "outcome": { "type": "string" }, "probability": { "type": "number", "format": "double" }, "timeframe": { "type": "string" } } }, "RiskAssessmentDTO": { "type": "object", "properties": { "id": { "type": "string" }, "patientId": { "type": "string", "format": "uuid" }, "riskCategory": { "type": "string" }, "riskScore": { "type": "integer", "format": "int32" }, "riskLevel": { "type": "string" }, "riskFactors": { "type": "array", "items": { "$ref": "#/components/schemas/RiskFactorDTO" } }, "predictedOutcomes": { "type": "array", "items": { "$ref": "#/components/schemas/PredictedOutcomeDTO" } }, "recommendations": { "type": "array", "items": { "type": "string" } }, "assessmentDate": { "type": "string", "format": "date-time" }, "createdAt": { "type": "string", "format": "date-time" } } }, "RiskFactorDTO": { "type": "object", "properties": { "factor": { "type": "string" }, "category": { "type": "string" }, "weight": { "type": "integer", "format": "int32" }, "severity": { "type": "string" }, "evidence": { "type": "string" } } }, "MentalHealthAssessmentRequest": { "required": [ "assessedBy", "assessmentType", "patientId", "responses" ], "type": "object", "properties": { "patientId": { "type": "string", "format": "uuid" }, "assessmentType": { "type": "string" }, "responses": { "type": "object", "additionalProperties": { "type": "integer", "format": "int32" } }, "assessedBy": { "type": "string" }, "assessmentDate": { "type": "string", "format": "date-time" }, "clinicalNotes": { "type": "string" } } }, "MentalHealthAssessmentDTO": { "type": "object", "properties": { "id": { "type": "string" }, "patientId": { "type": "string", "format": "uuid" }, "type": { "type": "string" }, "name": { "type": "string" }, "score": { "type": "integer", "format": "int32" }, "maxScore": { "type": "integer", "format": "int32" }, "severity": { "type": "string" }, "interpretation": { "type": "string" }, "positiveScreen": { "type": "boolean" }, "thresholdScore": { "type": "integer", "format": "int32" }, "requiresFollowup": { "type": "boolean" }, "assessedBy": { "type": "string" }, "assessmentDate": { "type": "string", "format": "date-time" }, "createdAt": { "type": "string", "format": "date-time" } } }, "CdsEvaluateRequest": { "required": [ "patientId" ], "type": "object", "properties": { "patientId": { "type": "string", "format": "uuid" }, "ruleIds": { "type": "array", "items": { "type": "string", "format": "uuid" } }, "categories": { "type": "array", "items": { "type": "string" } }, "forceReEvaluation": { "type": "boolean" }, "includeRuleDetails": { "type": "boolean" } } }, "CdsEvaluateResponse": { "type": "object", "properties": { "patientId": { "type": "string", "format": "uuid" }, "evaluatedAt": { "type": "string", "format": "date-time" }, "rulesEvaluated": { "type": "integer", "format": "int32" }, "recommendationsGenerated": { "type": "integer", "format": "int32" }, "existingRecommendationsSkipped": { "type": "integer", "format": "int32" }, "newRecommendations": { "type": "array", "items": { "$ref": "#/components/schemas/CdsRecommendationDTO" } }, "existingRecommendations": { "type": "array", "items": { "$ref": "#/components/schemas/CdsRecommendationDTO" } }, "recommendationsByCategory": { "type": "object", "additionalProperties": { "type": "integer", "format": "int32" } }, "recommendationsByUrgency": { "type": "object", "additionalProperties": { "type": "integer", "format": "int32" } }, "evaluationDetails": { "type": "array", "items": { "$ref": "#/components/schemas/EvaluationDetail" } } } }, "CdsRecommendationDTO": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "patientId": { "type": "string", "format": "uuid" }, "ruleId": { "type": "string", "format": "uuid" }, "title": { "type": "string" }, "description": { "type": "string" }, "category": { "type": "string" }, "urgency": { "type": "string" }, "status": { "type": "string" }, "priority": { "type": "integer", "format": "int32" }, "actionItems": { "type": "array", "items": { "type": "string" } }, "suggestedIntervention": { "type": "string" }, "evidenceSource": { "type": "string" }, "clinicalGuideline": { "type": "string" }, "relatedCareGapId": { "type": "string", "format": "uuid" }, "relatedMeasureId": { "type": "string" }, "relatedMeasureName": { "type": "string" }, "dueDate": { "type": "string", "format": "date-time" }, "daysOverdue": { "type": "integer", "format": "int64" }, "evaluatedAt": { "type": "string", "format": "date-time" }, "acknowledgedAt": { "type": "string", "format": "date-time" }, "acknowledgedBy": { "type": "string" }, "completedAt": { "type": "string", "format": "date-time" }, "completedBy": { "type": "string" }, "completionOutcome": { "type": "string" }, "declinedAt": { "type": "string", "format": "date-time" }, "declinedBy": { "type": "string" }, "declineReason": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" }, "patientName": { "type": "string" }, "patientMrn": { "type": "string" }, "patientRiskLevel": { "type": "string" } } }, "EvaluationDetail": { "type": "object", "properties": { "ruleCode": { "type": "string" }, "ruleName": { "type": "string" }, "triggered": { "type": "boolean" }, "result": { "type": "string" }, "errorMessage": { "type": "string" }, "evaluationTimeMs": { "type": "integer", "format": "int64" } } }, "CdsAcknowledgeRequest": { "required": [ "action", "recommendationId" ], "type": "object", "properties": { "recommendationId": { "type": "string", "format": "uuid" }, "action": { "type": "string" }, "reason": { "type": "string" }, "notes": { "type": "string" }, "outcome": { "type": "string" }, "followUpDate": { "type": "string", "format": "date-time" }, "followUpNotes": { "type": "string" }, "userId": { "type": "string" }, "userName": { "type": "string" }, "userRole": { "type": "string" } } }, "AbnormalAcknowledgment": { "required": [ "acknowledged", "resultId" ], "type": "object", "properties": { "resultId": { "type": "string", "format": "uuid" }, "acknowledged": { "type": "boolean" }, "notes": { "type": "string", "description": "Notes explaining the acknowledgment" } }, "description": "Acknowledgments for abnormal results requiring individual review" }, "BulkSignRequest": { "required": [ "resultIds", "signatureType" ], "type": "object", "properties": { "resultIds": { "type": "array", "description": "List of result IDs to sign", "items": { "type": "string", "description": "List of result IDs to sign", "format": "uuid" } }, "signatureType": { "type": "string", "description": "Type of electronic signature", "example": "ELECTRONIC", "enum": [ "ELECTRONIC", "DIGITAL_CERTIFICATE", "BIOMETRIC" ] }, "acknowledgments": { "type": "array", "description": "Acknowledgments for abnormal results requiring individual review", "items": { "$ref": "#/components/schemas/AbnormalAcknowledgment" } }, "notes": { "type": "string", "description": "Optional notes for the signing action" } }, "description": "Bulk sign request" }, "BulkSignResponse": { "type": "object", "properties": { "signed": { "type": "integer", "description": "Number of results successfully signed", "format": "int32" }, "requiresAcknowledgment": { "type": "integer", "description": "Number of abnormal results requiring individual acknowledgment", "format": "int32" }, "failed": { "type": "integer", "description": "Number of results that failed to sign", "format": "int32" }, "signedAt": { "type": "string", "description": "Timestamp when signing was completed", "format": "date-time" }, "signedBy": { "type": "string", "description": "ID of the provider who signed" }, "pendingAbnormal": { "type": "array", "description": "List of abnormal results pending acknowledgment", "items": { "$ref": "#/components/schemas/PendingAbnormalResult" } }, "failedResults": { "type": "array", "description": "List of result IDs that failed to sign with reasons", "items": { "$ref": "#/components/schemas/FailedResult" } } }, "description": "Response from bulk signing operation" }, "FailedResult": { "type": "object", "properties": { "resultId": { "type": "string", "description": "Result ID", "format": "uuid" }, "reason": { "type": "string", "description": "Reason for failure" } }, "description": "Result that failed to sign" }, "PendingAbnormalResult": { "type": "object", "properties": { "resultId": { "type": "string", "description": "Result ID", "format": "uuid" }, "patientName": { "type": "string", "description": "Patient name" }, "resultType": { "type": "string", "description": "Type of result (e.g., HbA1c, BP)" }, "value": { "type": "string", "description": "Result value" }, "abnormalReason": { "type": "string", "description": "Reason result is flagged as abnormal" }, "measureName": { "type": "string", "description": "Measure name" } }, "description": "Abnormal result requiring provider review" }, "CreateVersionRequest": { "required": [ "cqlText", "measureId", "versionType" ], "type": "object", "properties": { "measureId": { "type": "string", "format": "uuid" }, "versionType": { "type": "string", "enum": [ "MAJOR", "MINOR", "PATCH" ] }, "cqlText": { "type": "string" }, "valueSets": { "type": "string" }, "changeSummary": { "type": "string" }, "metadata": { "type": "string" } } }, "MeasureVersionDTO": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "measureId": { "type": "string", "format": "uuid" }, "version": { "type": "string" }, "versionType": { "type": "string", "enum": [ "MAJOR", "MINOR", "PATCH" ] }, "cqlText": { "type": "string" }, "valueSets": { "type": "string" }, "metadata": { "type": "string" }, "changeSummary": { "type": "string" }, "createdBy": { "type": "string", "format": "uuid" }, "createdByName": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time" }, "isCurrent": { "type": "boolean" }, "isPublished": { "type": "boolean" }, "publishedAt": { "type": "string", "format": "date-time" }, "publishedBy": { "type": "string", "format": "uuid" } } }, "SeedResponse": { "type": "object", "properties": { "seededCount": { "type": "integer", "format": "int32" }, "message": { "type": "string" } } }, "CqlValidateRequest": { "required": [ "cqlCode" ], "type": "object", "properties": { "cqlCode": { "type": "string" } } }, "CqlGenerationResponse": { "type": "object", "properties": { "id": { "type": "string" }, "generatedCql": { "type": "string" }, "explanation": { "type": "string" }, "confidence": { "type": "number", "format": "double" }, "validationStatus": { "type": "string", "enum": [ "VALID", "INVALID", "WARNINGS", "NOT_VALIDATED", "ERROR" ] }, "validationResult": { "$ref": "#/components/schemas/ValidationResult" }, "testResults": { "$ref": "#/components/schemas/TestResults" }, "warnings": { "type": "array", "items": { "type": "string" } }, "suggestions": { "type": "array", "items": { "$ref": "#/components/schemas/Suggestion" } }, "metadata": { "$ref": "#/components/schemas/GenerationMetadata" }, "generatedAt": { "type": "string", "format": "date-time" }, "modelVersion": { "type": "string" } } }, "GenerationMetadata": { "type": "object", "properties": { "inputTokens": { "type": "integer", "format": "int32" }, "outputTokens": { "type": "integer", "format": "int32" }, "generationTimeMs": { "type": "integer", "format": "int64" }, "promptTemplate": { "type": "string" }, "additionalInfo": { "type": "object", "additionalProperties": { "type": "object" } } } }, "PatientTestResult": { "type": "object", "properties": { "patientId": { "type": "string" }, "inDenominator": { "type": "boolean" }, "inNumerator": { "type": "boolean" }, "reason": { "type": "string" } } }, "Suggestion": { "type": "object", "properties": { "type": { "type": "string" }, "description": { "type": "string" }, "suggestedCode": { "type": "string" }, "impact": { "type": "number", "format": "double" } } }, "TestResults": { "type": "object", "properties": { "executed": { "type": "boolean" }, "sampleSize": { "type": "integer", "format": "int32" }, "numerator": { "type": "integer", "format": "int32" }, "denominator": { "type": "integer", "format": "int32" }, "complianceRate": { "type": "number", "format": "double" }, "patientResults": { "type": "array", "items": { "$ref": "#/components/schemas/PatientTestResult" } }, "executionError": { "type": "string" } } }, "ValidationError": { "type": "object", "properties": { "severity": { "type": "string" }, "message": { "type": "string" }, "line": { "type": "integer", "format": "int32" }, "column": { "type": "integer", "format": "int32" }, "code": { "type": "string" } } }, "ValidationResult": { "type": "object", "properties": { "syntaxValid": { "type": "boolean" }, "semanticValid": { "type": "boolean" }, "errors": { "type": "array", "items": { "$ref": "#/components/schemas/ValidationError" } }, "warnings": { "type": "array", "items": { "type": "string" } }, "errorCount": { "type": "integer", "format": "int32" }, "warningCount": { "type": "integer", "format": "int32" } } }, "CqlGenerationRequest": { "required": [ "description", "measureType" ], "type": "object", "properties": { "description": { "maxLength": 2000, "minLength": 10, "type": "string" }, "measureType": { "type": "string" }, "measureName": { "type": "string" }, "context": { "$ref": "#/components/schemas/GenerationContext" }, "validateCql": { "type": "boolean" }, "runTests": { "type": "boolean" }, "sampleSize": { "type": "integer", "format": "int32" } } }, "GenerationContext": { "type": "object", "properties": { "existingConditions": { "type": "array", "items": { "type": "string" } }, "relevantValueSets": { "type": "array", "items": { "type": "string" } }, "population": { "$ref": "#/components/schemas/PopulationCriteria" }, "metadata": { "type": "object", "additionalProperties": { "type": "object" } } } }, "PopulationCriteria": { "type": "object", "properties": { "minAge": { "type": "integer", "format": "int32" }, "maxAge": { "type": "integer", "format": "int32" }, "gender": { "type": "string" }, "includedConditions": { "type": "array", "items": { "type": "string" } }, "excludedConditions": { "type": "array", "items": { "type": "string" } } } }, "CqlExplainRequest": { "required": [ "cqlCode" ], "type": "object", "properties": { "cqlCode": { "type": "string" }, "detailLevel": { "type": "string", "enum": [ "SUMMARY", "DETAILED", "EDUCATIONAL" ] }, "includeSuggestions": { "type": "boolean" } } }, "ClinicalConcept": { "type": "object", "properties": { "name": { "type": "string" }, "description": { "type": "string" }, "codeSystem": { "type": "string" }, "valueSetOid": { "type": "string" }, "usage": { "type": "string" } } }, "CqlExplainResponse": { "type": "object", "properties": { "id": { "type": "string" }, "summary": { "type": "string" }, "sections": { "type": "array", "items": { "$ref": "#/components/schemas/SectionExplanation" } }, "clinicalConcepts": { "type": "array", "items": { "$ref": "#/components/schemas/ClinicalConcept" } }, "dataElements": { "type": "array", "items": { "$ref": "#/components/schemas/DataElement" } }, "potentialIssues": { "type": "array", "items": { "type": "string" } }, "suggestions": { "type": "array", "items": { "$ref": "#/components/schemas/Suggestion" } }, "complexityRating": { "type": "integer", "format": "int32" }, "performanceAssessment": { "$ref": "#/components/schemas/PerformanceAssessment" }, "explainedAt": { "type": "string", "format": "date-time" } } }, "DataElement": { "type": "object", "properties": { "resourceType": { "type": "string" }, "element": { "type": "string" }, "purpose": { "type": "string" }, "required": { "type": "boolean" } } }, "PerformanceAssessment": { "type": "object", "properties": { "rating": { "type": "string" }, "concerns": { "type": "array", "items": { "type": "string" } }, "recommendations": { "type": "array", "items": { "type": "string" } }, "estimatedDataQueries": { "type": "integer", "format": "int32" } } }, "SectionExplanation": { "type": "object", "properties": { "sectionName": { "type": "string" }, "cqlSnippet": { "type": "string" }, "explanation": { "type": "string" }, "purpose": { "type": "string" }, "lineStart": { "type": "integer", "format": "int32" }, "lineEnd": { "type": "integer", "format": "int32" } } }, "DemoResultsRequest": { "type": "object", "properties": { "patientIds": { "type": "array", "items": { "type": "string" } }, "careGapPercentage": { "type": "integer", "format": "int32" }, "measureIds": { "type": "array", "items": { "type": "string" } } } }, "DemoResultsResponse": { "type": "object", "properties": { "resultsGenerated": { "type": "integer", "format": "int32" }, "compliantCount": { "type": "integer", "format": "int32" }, "nonCompliantCount": { "type": "integer", "format": "int32" } } }, "QualityScore": { "type": "object", "properties": { "totalMeasures": { "type": "integer", "format": "int64" }, "compliantMeasures": { "type": "integer", "format": "int64" }, "scorePercentage": { "type": "number", "format": "double" } } }, "PopulationQualityReport": { "type": "object", "properties": { "year": { "type": "integer", "format": "int32" }, "uniquePatients": { "type": "integer", "format": "int64" }, "totalMeasures": { "type": "integer", "format": "int64" }, "compliantMeasures": { "type": "integer", "format": "int64" }, "overallScore": { "type": "number", "format": "double" }, "measuresByCategory": { "type": "object", "additionalProperties": { "type": "integer", "format": "int64" } } } }, "QualityReport": { "type": "object", "properties": { "patientId": { "type": "string", "format": "uuid" }, "totalMeasures": { "type": "integer", "format": "int64" }, "compliantMeasures": { "type": "integer", "format": "int64" }, "qualityScore": { "type": "number", "format": "double" }, "measuresByCategory": { "type": "object", "additionalProperties": { "type": "integer", "format": "int64" } }, "careGapSummary": { "type": "string" } } }, "ComponentScoresDTO": { "type": "object", "properties": { "physical": { "type": "integer", "format": "int32" }, "mental": { "type": "integer", "format": "int32" }, "social": { "type": "integer", "format": "int32" }, "preventive": { "type": "integer", "format": "int32" }, "chronicDisease": { "type": "integer", "format": "int32" } } }, "HealthScoreDTO": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "patientId": { "type": "string", "format": "uuid" }, "tenantId": { "type": "string" }, "overallScore": { "type": "number", "format": "double" }, "physicalHealthScore": { "type": "number", "format": "double" }, "mentalHealthScore": { "type": "number", "format": "double" }, "socialDeterminantsScore": { "type": "number", "format": "double" }, "preventiveCareScore": { "type": "number", "format": "double" }, "chronicDiseaseScore": { "type": "number", "format": "double" }, "calculatedAt": { "type": "string", "format": "date-time" }, "previousScore": { "type": "number", "format": "double" }, "scoreDelta": { "type": "number", "format": "double" }, "significantChange": { "type": "boolean" }, "changeReason": { "type": "string" }, "scoreLevel": { "type": "string" }, "interpretation": { "type": "string" }, "componentScores": { "$ref": "#/components/schemas/ComponentScoresDTO" }, "trend": { "type": "string" } } }, "PageHealthScoreDTO": { "type": "object", "properties": { "totalPages": { "type": "integer", "format": "int32" }, "totalElements": { "type": "integer", "format": "int64" }, "pageable": { "$ref": "#/components/schemas/PageableObject" }, "numberOfElements": { "type": "integer", "format": "int32" }, "first": { "type": "boolean" }, "last": { "type": "boolean" }, "size": { "type": "integer", "format": "int32" }, "content": { "type": "array", "items": { "$ref": "#/components/schemas/HealthScoreDTO" } }, "number": { "type": "integer", "format": "int32" }, "sort": { "type": "array", "items": { "$ref": "#/components/schemas/SortObject" } }, "empty": { "type": "boolean" } } }, "PageableObject": { "type": "object", "properties": { "paged": { "type": "boolean" }, "pageSize": { "type": "integer", "format": "int32" }, "unpaged": { "type": "boolean" }, "pageNumber": { "type": "integer", "format": "int32" }, "offset": { "type": "integer", "format": "int64" }, "sort": { "type": "array", "items": { "$ref": "#/components/schemas/SortObject" } } } }, "SortObject": { "type": "object", "properties": { "direction": { "type": "string" }, "nullHandling": { "type": "string" }, "ascending": { "type": "boolean" }, "property": { "type": "string" }, "ignoreCase": { "type": "boolean" } } }, "PatientHealthOverviewDTO": { "type": "object", "properties": { "patientId": { "type": "string", "format": "uuid" }, "healthScore": { "$ref": "#/components/schemas/HealthScoreDTO" }, "recentMentalHealthAssessments": { "type": "array", "items": { "$ref": "#/components/schemas/MentalHealthAssessmentDTO" } }, "openCareGaps": { "type": "array", "items": { "$ref": "#/components/schemas/CareGapDTO" } }, "riskAssessment": { "$ref": "#/components/schemas/RiskAssessmentDTO" }, "summaryStats": { "$ref": "#/components/schemas/SummaryStatsDTO" } } }, "SummaryStatsDTO": { "type": "object", "properties": { "totalOpenCareGaps": { "type": "integer", "format": "int32" }, "urgentCareGaps": { "type": "integer", "format": "int32" }, "totalMentalHealthAssessments": { "type": "integer", "format": "int32" }, "positiveScreensRequiringFollowup": { "type": "integer", "format": "int32" } } }, "AssessmentTrend": { "type": "object", "properties": { "patientId": { "type": "string", "format": "uuid" }, "assessmentType": { "type": "string" }, "trend": { "type": "string" }, "dataPoints": { "type": "array", "items": { "$ref": "#/components/schemas/DataPoint" } }, "averageScore": { "type": "number", "format": "double" }, "currentSeverity": { "type": "string" }, "previousSeverity": { "type": "string" } } }, "DataPoint": { "type": "object", "properties": { "date": { "type": "string", "format": "date-time" }, "score": { "type": "integer", "format": "int32" } } }, "MeasureMetadata": { "type": "object", "properties": { "measureId": { "type": "string" }, "measureName": { "type": "string" }, "version": { "type": "string" } } }, "CdsRuleDTO": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "ruleName": { "type": "string" }, "ruleCode": { "type": "string" }, "description": { "type": "string" }, "category": { "type": "string" }, "priority": { "type": "integer", "format": "int32" }, "cqlLibraryName": { "type": "string" }, "cqlExpression": { "type": "string" }, "recommendationTemplate": { "type": "string" }, "evidenceSource": { "type": "string" }, "clinicalGuideline": { "type": "string" }, "actionItems": { "type": "array", "items": { "type": "string" } }, "defaultUrgency": { "type": "string" }, "active": { "type": "boolean" }, "requiresAcknowledgment": { "type": "boolean" }, "applicableConditions": { "type": "array", "items": { "type": "string" } }, "exclusionCriteria": { "type": "array", "items": { "type": "string" } }, "version": { "type": "string" }, "createdBy": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" } } }, "RecommendationCountResponse": { "type": "object", "properties": { "patientId": { "type": "string", "format": "uuid" }, "totalActive": { "type": "integer", "format": "int64" }, "emergent": { "type": "integer", "format": "int64" }, "urgent": { "type": "integer", "format": "int64" }, "soon": { "type": "integer", "format": "int64" }, "routine": { "type": "integer", "format": "int64" } } }, "ResultSignatureEntity": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "resultId": { "type": "string", "format": "uuid" }, "tenantId": { "type": "string" }, "patientId": { "type": "string", "format": "uuid" }, "measureId": { "type": "string" }, "signedBy": { "type": "string" }, "signedByUsername": { "type": "string" }, "signedAt": { "type": "string", "format": "date-time" }, "signatureType": { "type": "string" }, "notes": { "type": "string" }, "numeratorCompliant": { "type": "boolean" }, "complianceRate": { "type": "number", "format": "double" }, "createdAt": { "type": "string", "format": "date-time" } } }, "MeasurePerformanceDTO": { "type": "object", "properties": { "measureId": { "type": "string" }, "measureName": { "type": "string" }, "category": { "type": "string" }, "providerRate": { "type": "number", "format": "double" }, "practiceAverage": { "type": "number", "format": "double" }, "nationalBenchmark": { "type": "number", "format": "double" }, "percentile": { "type": "integer", "format": "int32" }, "numerator": { "type": "integer", "format": "int32" }, "denominator": { "type": "integer", "format": "int32" }, "trend": { "type": "array", "items": { "$ref": "#/components/schemas/MonthlyTrendDTO" } }, "changeFromPrevious": { "type": "number", "format": "double" }, "trendDirection": { "type": "string" }, "performanceStatus": { "type": "string" }, "requiresAttention": { "type": "boolean" }, "gapToNextTier": { "type": "integer", "format": "int32" } } }, "MonthlyTrendDTO": { "type": "object", "properties": { "month": { "type": "string" }, "rate": { "type": "number", "format": "double" }, "numerator": { "type": "integer", "format": "int32" }, "denominator": { "type": "integer", "format": "int32" }, "practiceAverage": { "type": "number", "format": "double" } } }, "ProviderPerformanceResponse": { "type": "object", "properties": { "providerId": { "type": "string", "format": "uuid" }, "providerName": { "type": "string" }, "period": { "type": "string" }, "measures": { "type": "array", "items": { "$ref": "#/components/schemas/MeasurePerformanceDTO" } }, "overallScore": { "type": "number", "format": "double" }, "overallPercentile": { "type": "integer", "format": "int32" }, "totalPatients": { "type": "integer", "format": "int32" }, "totalEligible": { "type": "integer", "format": "int32" }, "totalCompliant": { "type": "integer", "format": "int32" }, "improvementAreas": { "type": "array", "items": { "type": "string" } }, "strengthAreas": { "type": "array", "items": { "type": "string" } }, "calculatedAt": { "type": "string" } } }, "MeasureDTO": { "type": "object", "properties": { "id": { "type": "string" }, "measureId": { "type": "string" }, "measureName": { "type": "string" }, "measureSet": { "type": "string" }, "version": { "type": "string" }, "domain": { "type": "string" }, "category": { "type": "string" }, "description": { "type": "string" }, "active": { "type": "boolean" } } }, "PageMeasureVersionDTO": { "type": "object", "properties": { "totalPages": { "type": "integer", "format": "int32" }, "totalElements": { "type": "integer", "format": "int64" }, "pageable": { "$ref": "#/components/schemas/PageableObject" }, "numberOfElements": { "type": "integer", "format": "int32" }, "first": { "type": "boolean" }, "last": { "type": "boolean" }, "size": { "type": "integer", "format": "int32" }, "content": { "type": "array", "items": { "$ref": "#/components/schemas/MeasureVersionDTO" } }, "number": { "type": "integer", "format": "int32" }, "sort": { "type": "array", "items": { "$ref": "#/components/schemas/SortObject" } }, "empty": { "type": "boolean" } } }, "VersionComparisonDTO": { "type": "object", "properties": { "version1": { "type": "string" }, "version2": { "type": "string" }, "cqlChanged": { "type": "boolean" }, "valueSetsChanged": { "type": "boolean" }, "cql1": { "type": "string" }, "cql2": { "type": "string" }, "valueSets1": { "type": "string" }, "valueSets2": { "type": "string" }, "createdAt1": { "type": "string", "format": "date-time" }, "createdAt2": { "type": "string", "format": "date-time" } } }, "CqlTemplate": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "description": { "type": "string" }, "category": { "type": "string" }, "measureType": { "type": "string" }, "tags": { "type": "array", "items": { "type": "string" } } } }, "CqlTemplateDetail": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "description": { "type": "string" }, "category": { "type": "string" }, "measureType": { "type": "string" }, "tags": { "type": "array", "items": { "type": "string" } }, "cqlCode": { "type": "string" }, "explanation": { "type": "string" }, "requiredValueSets": { "type": "array", "items": { "type": "string" } } } }, "PopulationRiskStats": { "type": "object", "properties": { "totalPatients": { "type": "integer", "format": "int64" }, "riskLevelDistribution": { "type": "object", "additionalProperties": { "type": "integer", "format": "int64" } } } }, "Link": { "type": "object", "properties": { "href": { "type": "string" }, "templated": { "type": "boolean" } } }, "BatchDeleteRequest": { "required": [ "measureIds" ], "type": "object", "properties": { "measureIds": { "type": "array", "items": { "type": "string", "format": "uuid" } }, "force": { "type": "boolean" } } }, "BatchDeleteResponse": { "type": "object", "properties": { "deletedCount": { "type": "integer", "format": "int32" }, "failedCount": { "type": "integer", "format": "int32" }, "errors": { "type": "array", "items": { "type": "string" } }, "measuresInUse": { "type": "array", "items": { "type": "string" } } } } } } }