---
title: "GET /api/patient-chart-analysis/{id}"
method: GET
path: "/api/patient-chart-analysis/{id}"
---

# GET /api/patient-chart-analysis/{id}

`GET /api/patient-chart-analysis/{id}`

Fetches a patient chart analysis result by its ID. Returns the comprehensive medical coding and documentation report including all sub-reports.

## Path parameters

- `id` string, required

## Response `200`

Patient chart analysis retrieved successfully

- GetChartAnalysisResponse — Response containing patient chart analysis results
  - `id` string, uuid, required — Unique identifier for the patient chart analysis
  - `status` 'complete' | 'processing' | 'failed' | 'pending', required — Status of the analysis
  - `completed_events` string[], required — List of completed analysis events
  - `report` ChartAnalysisReport, required — Comprehensive patient chart analysis report
    - `id` string, uuid, required — Unique identifier for the report
    - `claim_id` string, required — Associated claim identifier, if applicable
    - `coding_report` CodingReport, required — Coding report containing ICD-10 and CPT codes
      - `icd_10_codes` string[], required — List of ICD-10 diagnosis codes
      - `cpt_codes` object[], required — List of CPT procedure codes
        - `cpt_code` string, required — CPT code
        - `severity` 'Low' | 'Medium' | 'High', required — Severity level of the finding
        - `units` number — Units of the CPT code
    - `documentation_discrepancy_report` DocumentationDiscrepancyReport, required — Report on documentation discrepancies
      - `chief_complaint_hpi_discrepancy` ReportField, required — Standard report field with label, value, and severity
        - `label` string, required — Field label or name
        - `value` string, required — Field value
        - `severity` 'Low' | 'Medium' | 'High', required — Severity level of the finding
      - `ros_hpi_discrepancy` ReportField, required — Standard report field with label, value, and severity
        - `label` string, required — Field label or name
        - `value` string, required — Field value
        - `severity` 'Low' | 'Medium' | 'High', required — Severity level of the finding
      - `vitals_exam_discrepancy` ReportField, required — Standard report field with label, value, and severity
        - `label` string, required — Field label or name
        - `value` string, required — Field value
        - `severity` 'Low' | 'Medium' | 'High', required — Severity level of the finding
      - `report_summary` string, required — Summary of the documentation discrepancy findings
      - `status` 'Pass' | 'Fail' | 'Warning', required — Overall status of the report
    - `ncd_lcd_analysis` NcdLcdAnalysis, required — National Coverage Determination and Local Coverage Determination analysis
      - `diagnoses_match_ncd_lcd` ReportField, required — Standard report field with label, value, and severity
        - `label` string, required — Field label or name
        - `value` string, required — Field value
        - `severity` 'Low' | 'Medium' | 'High', required — Severity level of the finding
      - `frequency_discrepancy` ReportField, required — Standard report field with label, value, and severity
        - `label` string, required — Field label or name
        - `value` string, required — Field value
        - `severity` 'Low' | 'Medium' | 'High', required — Severity level of the finding
      - `age_discrepancy` ReportField, required — Standard report field with label, value, and severity
        - `label` string, required — Field label or name
        - `value` string, required — Field value
        - `severity` 'Low' | 'Medium' | 'High', required — Severity level of the finding
      - `place_of_service_discrepancy` ReportField, required — Standard report field with label, value, and severity
        - `label` string, required — Field label or name
        - `value` string, required — Field value
        - `severity` 'Low' | 'Medium' | 'High', required — Severity level of the finding
      - `report_summary` string, required — Summary of the NCD/LCD analysis findings
      - `status` 'Pass' | 'Fail' | 'Warning', required — Overall status of the report
    - `suggestions_for_fixing_issues_report` SuggestionsForFixingIssuesReport, required — Report containing suggestions for fixing identified issues
      - `suggestions` string[], required — List of suggestions for fixing issues
    - `time_based_requirements_report` TimeBasedRequirementsReport, required — Report on time-based documentation requirements
      - `total_time_documented` ReportField, required — Standard report field with label, value, and severity
        - `label` string, required — Field label or name
        - `value` string, required — Field value
        - `severity` 'Low' | 'Medium' | 'High', required — Severity level of the finding
      - `start_time` ReportField, required — Standard report field with label, value, and severity
        - `label` string, required — Field label or name
        - `value` string, required — Field value
        - `severity` 'Low' | 'Medium' | 'High', required — Severity level of the finding
      - `end_time` ReportField, required — Standard report field with label, value, and severity
        - `label` string, required — Field label or name
        - `value` string, required — Field value
        - `severity` 'Low' | 'Medium' | 'High', required — Severity level of the finding
      - `time_range_matches_procedure` ReportField, required — Standard report field with label, value, and severity
        - `label` string, required — Field label or name
        - `value` string, required — Field value
        - `severity` 'Low' | 'Medium' | 'High', required — Severity level of the finding
      - `codes_consistent` ReportField, required — Standard report field with label, value, and severity
        - `label` string, required — Field label or name
        - `value` string, required — Field value
        - `severity` 'Low' | 'Medium' | 'High', required — Severity level of the finding
      - `report_summary` string, required — Summary of the time-based requirements findings
      - `status` 'Pass' | 'Fail' | 'Warning', required — Overall status of the report
    - `telehealth_documentation_report` TelehealthDocumentationReport, required — Report on telehealth documentation requirements
      - `patient_location` ReportField, required — Standard report field with label, value, and severity
        - `label` string, required — Field label or name
        - `value` string, required — Field value
        - `severity` 'Low' | 'Medium' | 'High', required — Severity level of the finding
      - `provider_location` ReportField, required — Standard report field with label, value, and severity
        - `label` string, required — Field label or name
        - `value` string, required — Field value
        - `severity` 'Low' | 'Medium' | 'High', required — Severity level of the finding
      - `modality` ReportField, required — Standard report field with label, value, and severity
        - `label` string, required — Field label or name
        - `value` string, required — Field value
        - `severity` 'Low' | 'Medium' | 'High', required — Severity level of the finding
      - `patient_consent` ReportField, required — Standard report field with label, value, and severity
        - `label` string, required — Field label or name
        - `value` string, required — Field value
        - `severity` 'Low' | 'Medium' | 'High', required — Severity level of the finding
      - `report_summary` string, required — Summary of the telehealth documentation findings
      - `status` 'Pass' | 'Fail' | 'Warning', required — Overall status of the report
    - `authentication_report` AuthenticationReport, required — Report on provider authentication and signature requirements
      - `provider_signature` ReportField, required — Standard report field with label, value, and severity
        - `label` string, required — Field label or name
        - `value` string, required — Field value
        - `severity` 'Low' | 'Medium' | 'High', required — Severity level of the finding
      - `signature_date` ReportField, required — Standard report field with label, value, and severity
        - `label` string, required — Field label or name
        - `value` string, required — Field value
        - `severity` 'Low' | 'Medium' | 'High', required — Severity level of the finding
      - `provider_credentials` ReportField, required — Standard report field with label, value, and severity
        - `label` string, required — Field label or name
        - `value` string, required — Field value
        - `severity` 'Low' | 'Medium' | 'High', required — Severity level of the finding
      - `provider_name` ReportField, required — Standard report field with label, value, and severity
        - `label` string, required — Field label or name
        - `value` string, required — Field value
        - `severity` 'Low' | 'Medium' | 'High', required — Severity level of the finding
      - `provider_cosignature` ReportField, required — Standard report field with label, value, and severity
        - `label` string, required — Field label or name
        - `value` string, required — Field value
        - `severity` 'Low' | 'Medium' | 'High', required — Severity level of the finding
      - `report_summary` string, required — Summary of the authentication findings
      - `status` 'Pass' | 'Fail' | 'Warning', required — Overall status of the report
    - `diagnosis_procedure_report_alignment` DiagnosisProcedureReportAlignment, required — Report on alignment between diagnoses and procedures
      - `diagnosis_matches_code` ReportField, required — Standard report field with label, value, and severity
        - `label` string, required — Field label or name
        - `value` string, required — Field value
        - `severity` 'Low' | 'Medium' | 'High', required — Severity level of the finding
      - `laterality_matches_code` ReportField, required — Standard report field with label, value, and severity
        - `label` string, required — Field label or name
        - `value` string, required — Field value
        - `severity` 'Low' | 'Medium' | 'High', required — Severity level of the finding
      - `acute_chronic_discrepancy` ReportField, required — Standard report field with label, value, and severity
        - `label` string, required — Field label or name
        - `value` string, required — Field value
        - `severity` 'Low' | 'Medium' | 'High', required — Severity level of the finding
      - `report_summary` string, required — Summary of the diagnosis-procedure alignment findings
      - `status` 'Pass' | 'Fail' | 'Warning', required — Overall status of the report
    - `modifier_bundling_report` ModifierBundlingReport, required — Report on modifier bundling requirements
      - `modifier_25_check` ReportField, required — Standard report field with label, value, and severity
        - `label` string, required — Field label or name
        - `value` string, required — Field value
        - `severity` 'Low' | 'Medium' | 'High', required — Severity level of the finding
      - `modifier_59_check` ReportField, required — Standard report field with label, value, and severity
        - `label` string, required — Field label or name
        - `value` string, required — Field value
        - `severity` 'Low' | 'Medium' | 'High', required — Severity level of the finding
      - `modifier_50_check` ReportField, required — Standard report field with label, value, and severity
        - `label` string, required — Field label or name
        - `value` string, required — Field value
        - `severity` 'Low' | 'Medium' | 'High', required — Severity level of the finding
      - `modifier_26_check` ReportField, required — Standard report field with label, value, and severity
        - `label` string, required — Field label or name
        - `value` string, required — Field value
        - `severity` 'Low' | 'Medium' | 'High', required — Severity level of the finding
      - `multiple_modifier_check` ReportField, required — Standard report field with label, value, and severity
        - `label` string, required — Field label or name
        - `value` string, required — Field value
        - `severity` 'Low' | 'Medium' | 'High', required — Severity level of the finding
      - `report_summary` string, required — Summary of the modifier bundling findings
      - `status` 'Pass' | 'Fail' | 'Warning', required — Overall status of the report
    - `created_at` string, date-time, required — Timestamp when the report was created
    - `organization_id` string, uuid, required — Organization identifier
    - `file_uri` string, required — URI or identifier of the analyzed file
    - `demographics` Demographics, required — Demographic information extracted from the patient chart
      - `patient_name` string, required — Patient's full name
      - `provider_name` string, required — Provider's full name
      - `date_of_service` string, required — Date of service
      - `patient_birth_date` string, required — Patient's date of birth
      - `facility_name` string, required — Name of the facility
    - `custom_rules_report` CustomRuleReport[], required — Custom rules violations and findings
      - `rule` string, required — Description of the custom rule
      - `tags` string, required — Tags associated with the rule
      - `rule_id` string, uuid, required — Unique identifier for the custom rule
      - `severity` 'Low' | 'Medium' | 'High', required — Severity level of the rule violation
      - `explanation` string, required — Detailed explanation of the rule violation
    - `last_updated` string, date-time, required — Timestamp when the report was last updated

## Other responses

- `400` — Invalid request - chart report id required
- `401` — Unauthorized access or invalid organization ID
- `404` — Patient chart analysis report not found
- `500` — Server error or analysis retrieval failure

---

[API](https://skmtc.net/cairhealth/apis/cair-health-apis.md) · [All operations](https://skmtc.net/cairhealth/apis/cair-health-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cairhealth/cair-health-apis/versions/dfc60069747b/schema)