> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cairhealth.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Fetch Patient Chart Report

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



## OpenAPI

````yaml GET /api/patient-chart-analysis/{id}
openapi: 3.1.0
info:
  title: Cair Health APIs
  description: APIs for the Cair Health platform
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://forecaster.cairhealth.com
security:
  - bearerAuth: []
paths:
  /api/patient-chart-analysis/{id}:
    get:
      description: >-
        Fetches a patient chart analysis result by its ID. Returns the
        comprehensive medical coding and documentation report including all
        sub-reports.
      parameters:
        - name: id
          in: path
          description: Unique identifier for the patient chart analysis (report ID)
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Patient chart analysis retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetChartAnalysisResponse'
        '400':
          description: Invalid request - chart report id required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetChartAnalysisResponse'
        '401':
          description: Unauthorized access or invalid organization ID
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Patient chart analysis report not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetChartAnalysisResponse'
        '500':
          description: Server error or analysis retrieval failure
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetChartAnalysisResponse'
      security:
        - bearerAuth: []
components:
  schemas:
    GetChartAnalysisResponse:
      type: object
      description: Response containing patient chart analysis results
      properties:
        id:
          type: string
          description: Unique identifier for the patient chart analysis
          format: uuid
        status:
          type: string
          description: Status of the analysis
          enum:
            - complete
            - processing
            - failed
            - pending
        completed_events:
          type: array
          description: List of completed analysis events
          items:
            type: string
            enum:
              - GENERATE_CODING_REPORT
              - GENERATE_TIME_BASED_REQUIREMENTS_REPORT
              - GENERATE_TELEHEALTH_DOCUMENTATION_REPORT
              - GENERATE_DOCUMENTATION_DISCREPANCY_REPORT
              - GENERATE_AUTHENTICATION_REPORT
              - GENERATE_DIAGNOSIS_PROCEDURE_ALIGNMENT_REPORT
              - GENERATE_MODIFIER_BUNDLING_REPORT
              - GENERATE_NCD_LCD_ANALYSIS_REPORT
              - GENERATE_SUGGESTIONS_FOR_FIXING_ISSUES_REPORT
              - GENERATE_CUSTOM_RULES_REPORT
              - GENERATE_DEMOGRAPHICS_INFO
        report:
          $ref: '#/components/schemas/ChartAnalysisReport'
      required:
        - id
        - status
        - completed_events
        - report
    Error:
      type: object
      properties:
        message:
          type: string
          description: Error message
    ChartAnalysisReport:
      type: object
      description: Comprehensive patient chart analysis report
      properties:
        id:
          type: string
          description: Unique identifier for the report
          format: uuid
        claim_id:
          type: string
          description: Associated claim identifier, if applicable
        coding_report:
          $ref: '#/components/schemas/CodingReport'
        documentation_discrepancy_report:
          $ref: '#/components/schemas/DocumentationDiscrepancyReport'
        ncd_lcd_analysis:
          $ref: '#/components/schemas/NcdLcdAnalysis'
        suggestions_for_fixing_issues_report:
          $ref: '#/components/schemas/SuggestionsForFixingIssuesReport'
        time_based_requirements_report:
          $ref: '#/components/schemas/TimeBasedRequirementsReport'
        telehealth_documentation_report:
          $ref: '#/components/schemas/TelehealthDocumentationReport'
        authentication_report:
          $ref: '#/components/schemas/AuthenticationReport'
        diagnosis_procedure_report_alignment:
          $ref: '#/components/schemas/DiagnosisProcedureReportAlignment'
        modifier_bundling_report:
          $ref: '#/components/schemas/ModifierBundlingReport'
        created_at:
          type: string
          description: Timestamp when the report was created
          format: date-time
        organization_id:
          type: string
          description: Organization identifier
          format: uuid
        file_uri:
          type: string
          description: URI or identifier of the analyzed file
        demographics:
          $ref: '#/components/schemas/Demographics'
        custom_rules_report:
          type: array
          description: Custom rules violations and findings
          items:
            $ref: '#/components/schemas/CustomRuleReport'
        last_updated:
          type: string
          description: Timestamp when the report was last updated
          format: date-time
      required:
        - id
        - claim_id
        - coding_report
        - documentation_discrepancy_report
        - ncd_lcd_analysis
        - suggestions_for_fixing_issues_report
        - time_based_requirements_report
        - telehealth_documentation_report
        - authentication_report
        - diagnosis_procedure_report_alignment
        - modifier_bundling_report
        - created_at
        - organization_id
        - file_uri
        - demographics
        - custom_rules_report
        - last_updated
    CodingReport:
      type: object
      description: Coding report containing ICD-10 and CPT codes
      properties:
        icd_10_codes:
          type: array
          description: List of ICD-10 diagnosis codes
          items:
            type: string
        cpt_codes:
          type: array
          description: List of CPT procedure codes
          items:
            type: object
            properties:
              cpt_code:
                type: string
                description: CPT code
              severity:
                type: string
                description: Severity level of the finding
                enum:
                  - Low
                  - Medium
                  - High
              units:
                type: number
                description: Units of the CPT code
            required:
              - cpt_code
              - severity
      required:
        - icd_10_codes
        - cpt_codes
    DocumentationDiscrepancyReport:
      type: object
      description: Report on documentation discrepancies
      properties:
        chief_complaint_hpi_discrepancy:
          $ref: '#/components/schemas/ReportField'
        ros_hpi_discrepancy:
          $ref: '#/components/schemas/ReportField'
        vitals_exam_discrepancy:
          $ref: '#/components/schemas/ReportField'
        report_summary:
          type: string
          description: Summary of the documentation discrepancy findings
        status:
          type: string
          description: Overall status of the report
          enum:
            - Pass
            - Fail
            - Warning
      required:
        - chief_complaint_hpi_discrepancy
        - ros_hpi_discrepancy
        - vitals_exam_discrepancy
        - report_summary
        - status
    NcdLcdAnalysis:
      type: object
      description: >-
        National Coverage Determination and Local Coverage Determination
        analysis
      properties:
        diagnoses_match_ncd_lcd:
          $ref: '#/components/schemas/ReportField'
        frequency_discrepancy:
          $ref: '#/components/schemas/ReportField'
        age_discrepancy:
          $ref: '#/components/schemas/ReportField'
        place_of_service_discrepancy:
          $ref: '#/components/schemas/ReportField'
        report_summary:
          type: string
          description: Summary of the NCD/LCD analysis findings
        status:
          type: string
          description: Overall status of the report
          enum:
            - Pass
            - Fail
            - Warning
      required:
        - diagnoses_match_ncd_lcd
        - frequency_discrepancy
        - age_discrepancy
        - place_of_service_discrepancy
        - report_summary
        - status
    SuggestionsForFixingIssuesReport:
      type: object
      description: Report containing suggestions for fixing identified issues
      properties:
        suggestions:
          type: array
          description: List of suggestions for fixing issues
          items:
            type: string
      required:
        - suggestions
    TimeBasedRequirementsReport:
      type: object
      description: Report on time-based documentation requirements
      properties:
        total_time_documented:
          $ref: '#/components/schemas/ReportField'
        start_time:
          $ref: '#/components/schemas/ReportField'
        end_time:
          $ref: '#/components/schemas/ReportField'
        time_range_matches_procedure:
          $ref: '#/components/schemas/ReportField'
        codes_consistent:
          $ref: '#/components/schemas/ReportField'
        report_summary:
          type: string
          description: Summary of the time-based requirements findings
        status:
          type: string
          description: Overall status of the report
          enum:
            - Pass
            - Fail
            - Warning
      required:
        - total_time_documented
        - start_time
        - end_time
        - time_range_matches_procedure
        - codes_consistent
        - report_summary
        - status
    TelehealthDocumentationReport:
      type: object
      description: Report on telehealth documentation requirements
      properties:
        patient_location:
          $ref: '#/components/schemas/ReportField'
        provider_location:
          $ref: '#/components/schemas/ReportField'
        modality:
          $ref: '#/components/schemas/ReportField'
        patient_consent:
          $ref: '#/components/schemas/ReportField'
        report_summary:
          type: string
          description: Summary of the telehealth documentation findings
        status:
          type: string
          description: Overall status of the report
          enum:
            - Pass
            - Fail
            - Warning
      required:
        - patient_location
        - provider_location
        - modality
        - patient_consent
        - report_summary
        - status
    AuthenticationReport:
      type: object
      description: Report on provider authentication and signature requirements
      properties:
        provider_signature:
          $ref: '#/components/schemas/ReportField'
        signature_date:
          $ref: '#/components/schemas/ReportField'
        provider_credentials:
          $ref: '#/components/schemas/ReportField'
        provider_name:
          $ref: '#/components/schemas/ReportField'
        provider_cosignature:
          $ref: '#/components/schemas/ReportField'
        report_summary:
          type: string
          description: Summary of the authentication findings
        status:
          type: string
          description: Overall status of the report
          enum:
            - Pass
            - Fail
            - Warning
      required:
        - provider_signature
        - signature_date
        - provider_credentials
        - provider_name
        - provider_cosignature
        - report_summary
        - status
    DiagnosisProcedureReportAlignment:
      type: object
      description: Report on alignment between diagnoses and procedures
      properties:
        diagnosis_matches_code:
          $ref: '#/components/schemas/ReportField'
        laterality_matches_code:
          $ref: '#/components/schemas/ReportField'
        acute_chronic_discrepancy:
          $ref: '#/components/schemas/ReportField'
        report_summary:
          type: string
          description: Summary of the diagnosis-procedure alignment findings
        status:
          type: string
          description: Overall status of the report
          enum:
            - Pass
            - Fail
            - Warning
      required:
        - diagnosis_matches_code
        - laterality_matches_code
        - acute_chronic_discrepancy
        - report_summary
        - status
    ModifierBundlingReport:
      type: object
      description: Report on modifier bundling requirements
      properties:
        modifier_25_check:
          $ref: '#/components/schemas/ReportField'
        modifier_59_check:
          $ref: '#/components/schemas/ReportField'
        modifier_50_check:
          $ref: '#/components/schemas/ReportField'
        modifier_26_check:
          $ref: '#/components/schemas/ReportField'
        multiple_modifier_check:
          $ref: '#/components/schemas/ReportField'
        report_summary:
          type: string
          description: Summary of the modifier bundling findings
        status:
          type: string
          description: Overall status of the report
          enum:
            - Pass
            - Fail
            - Warning
      required:
        - modifier_25_check
        - modifier_59_check
        - modifier_50_check
        - modifier_26_check
        - multiple_modifier_check
        - report_summary
        - status
    Demographics:
      type: object
      description: Demographic information extracted from the patient chart
      properties:
        patient_name:
          type: string
          description: Patient's full name
        provider_name:
          type: string
          description: Provider's full name
        date_of_service:
          type: string
          description: Date of service
        patient_birth_date:
          type: string
          description: Patient's date of birth
        facility_name:
          type: string
          description: Name of the facility
      required:
        - patient_name
        - provider_name
        - date_of_service
        - patient_birth_date
        - facility_name
    CustomRuleReport:
      type: object
      description: Custom rule violation or finding
      properties:
        rule:
          type: string
          description: Description of the custom rule
        tags:
          type: string
          description: Tags associated with the rule
        rule_id:
          type: string
          description: Unique identifier for the custom rule
          format: uuid
        severity:
          type: string
          description: Severity level of the rule violation
          enum:
            - Low
            - Medium
            - High
        explanation:
          type: string
          description: Detailed explanation of the rule violation
      required:
        - rule
        - tags
        - rule_id
        - severity
        - explanation
    ReportField:
      type: object
      description: Standard report field with label, value, and severity
      properties:
        label:
          type: string
          description: Field label or name
        value:
          type: string
          description: Field value
        severity:
          type: string
          description: Severity level of the finding
          enum:
            - Low
            - Medium
            - High
      required:
        - label
        - value
        - severity
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````