---
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}`

## Request

- Base URL: `https://forecaster.cairhealth.com`
- URL: `https://forecaster.cairhealth.com/api/patient-chart-analysis/{id}`
- Auth: HTTP bearer

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

## Changes

- **2026-11-03** `b32380ccde9a`: 1 info
  - added the optional property `error` to the response with the `401` status

[Operation history](https://skmtc.dev/cairhealth/apis/cair-health-apis/changes/api/patient-chart-analysis/:id/get.md)

---

[API](https://skmtc.dev/cairhealth/apis/cair-health-apis.md) - [All operations](https://skmtc.dev/cairhealth/apis/cair-health-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/cairhealth/apis/cair-health-apis/revisions/b32380ccde9a?raw)