POST
/
api
/
analyze-patient-chart
cURL
curl --request POST \
  --url https://forecaster.cairhealth.com/api/analyze-patient-chart \
  --header 'Authorization: Bearer <token>' \
  --header 'content-type: <content-type>'
{
  "success": true,
  "id": "a7985a6f-a7a2-4d52-af2a-a59520c63540",
  "created_at": "2024-01-01T00:00:00Z",
  "issues_for_review": 10,
  "checks_passed": 10,
  "demographics": {
    "patient_name": "John Doe",
    "provider_name": "Dr. John Smith",
    "date_of_service": "2024-01-01",
    "patient_birth_date": "1990-01-01",
    "facility_name": "Hospital A"
  },
  "analysis_result": {
    "chart_report": {
      "coding_report": {
        "icd_10_codes": [
          {
            "icd_10_code": "F33.1",
            "severity": "Low"
          },
          {
            "icd_10_code": "F90.2",
            "severity": "Low"
          },
          {
            "icd_10_code": "F12.20",
            "severity": "Low"
          },
          {
            "icd_10_code": "F51.01",
            "severity": "Low"
          },
          {
            "icd_10_code": "E03.9",
            "severity": "Low"
          },
          {
            "icd_10_code": "G56.00",
            "severity": "Low"
          },
          {
            "icd_10_code": "E66.9",
            "severity": "Low"
          },
          {
            "icd_10_code": "F41.9",
            "severity": "Low"
          },
          {
            "icd_10_code": "E78.2",
            "severity": "Low"
          },
          {
            "icd_10_code": "N92.6",
            "severity": "Low"
          },
          {
            "icd_10_code": "M54.50",
            "severity": "Low"
          },
          {
            "icd_10_code": "M54.16",
            "severity": "Low"
          },
          {
            "icd_10_code": "O09.90",
            "severity": "Low"
          },
          {
            "icd_10_code": "R05.9",
            "severity": "Low"
          }
        ],
        "cpt_codes": [
          {
            "cpt_code": "90791",
            "severity": "Low"
          },
          {
            "cpt_code": "90832",
            "severity": "Low"
          },
          {
            "cpt_code": "G2211",
            "severity": "Low"
          }
        ]
      },
      "documentation_discrepancy_report": {
        "chief_complaint_hpi_discrepancy": {
          "label": "Chief Complaint HPI Discrepancy",
          "value": "No",
          "severity": "Low"
        },
        "ros_hpi_discrepancy": {
          "label": "ROS HPI Discrepancy",
          "value": "No",
          "severity": "Low"
        },
        "vitals_exam_discrepancy": {
          "label": "Vitals Exam Discrepancy",
          "value": "No",
          "severity": "Low"
        },
        "report_summary": "All documentation discrepancy requirements are met. Chief complaint, ros, and vitals exam are consistent with the documentation.",
        "status": "Pass"
      },
      "time_based_requirements_report": {
        "total_time_documented": {
          "label": "Total Time Documented",
          "value": "32 minutes",
          "severity": "Low"
        },
        "start_time": {
          "label": "Start Time",
          "value": "Unknown",
          "severity": "Medium"
        },
        "end_time": {
          "label": "End Time",
          "value": "Unknown",
          "severity": "Medium"
        },
        "time_range_matches_procedure": {
          "label": "Time Range Matches Procedure",
          "value": "Yes",
          "severity": "Low"
        },
        "codes_consistent": {
          "label": "Codes Consistent",
          "value": "Yes",
          "severity": "Low"
        },
        "report_summary": "The time range is unknown, and requires further review. The document is otherwise compliant with the time based requirements.",
        "status": "Fail"
      },
      "telehealth_documentation_report": {
        "patient_location": {
          "label": "Patient Location",
          "value": "Not specified",
          "severity": "Medium"
        },
        "provider_location": {
          "label": "Provider Location",
          "value": "Not specified",
          "severity": "Medium"
        },
        "modality": {
          "label": "Modality",
          "value": "Video and audio",
          "severity": "Low"
        },
        "patient_consent": {
          "label": "Patient Consent",
          "value": "Implied consent",
          "severity": "Low"
        },
        "report_summary": "Telehealth visit was conducted via video and audio. Implied consent was obtained. Patient and provider locations are not specified.",
        "status": "Fail"
      },
      "authentication_report": {
        "provider_signature": {
          "label": "Provider Signature",
          "value": "No",
          "severity": "High"
        },
        "signature_date": {
          "label": "Signature Date",
          "value": "06/13/2025",
          "severity": "Low"
        },
        "provider_credentials": {
          "label": "Provider Credentials",
          "value": "NP",
          "severity": "Medium"
        },
        "provider_name": {
          "label": "Provider Name",
          "value": "N/A",
          "severity": "High"
        },
        "provider_cosignature": {
          "label": "Provider Co-Signature",
          "value": "Yes",
          "severity": "Low"
        },
        "report_summary": "Provider signature and name are missing. Provider credentials are listed as NP and a co-signature is present.",
        "status": "Fail"
      },
      "diagnosis_procedure_report_alignment": {
        "diagnosis_matches_code": {
          "label": "Diagnosis Matches Code",
          "value": "Yes",
          "severity": "Low"
        },
        "laterality_matches_code": {
          "label": "Laterality Matches Code",
          "value": "Yes",
          "severity": "Low"
        },
        "acute_chronic_discrepancy": {
          "label": "Acute/Chronic Discrepancy",
          "value": "No",
          "severity": "Low"
        },
        "report_summary": "All diagnosis-procedure alignment requirements are met. Diagnoses, laterality, and acute/chronic status are properly documented and coded.",
        "status": "Pass"
      },
      "modifier_bundling_report": {
        "modifier_25_check": {
          "label": "Modifier 25 Check",
          "value": "Yes",
          "severity": "Low"
        },
        "modifier_59_check": {
          "label": "Modifier 59 Check",
          "value": "No",
          "severity": "Low"
        },
        "modifier_50_check": {
          "label": "Modifier 50 Check",
          "value": "N/A",
          "severity": "Low"
        },
        "modifier_26_check": {
          "label": "Modifier 26 Check",
          "value": "N/A",
          "severity": "Low"
        },
        "multiple_modifier_check": {
          "label": "Multiple Modifier Check",
          "value": "No",
          "severity": "Low"
        },
        "report_summary": "All modifier bundling requirements are met. Modifier 25 is appropriately used for separate E/M service.",
        "status": "Pass"
      },
      "ncd_lcd_analysis": {
        "diagnoses_match_ncd_lcd": {
          "label": "Diagnoses Match NCD/LCD",
          "value": "Yes",
          "severity": "Low"
        },
        "frequency_discrepancy": {
          "label": "Frequency Discrepancy",
          "value": "No",
          "severity": "Low"
        },
        "age_discrepancy": {
          "label": "Age Discrepancy",
          "value": "No",
          "severity": "Low"
        },
        "place_of_service_discrepancy": {
          "label": "Place of Service Discrepancy",
          "value": "No",
          "severity": "Low"
        },
        "report_summary": "Diagnoses F33.1, F90.2, F12.20, F51.01, E03.9, G56.00, E66.9, F41.9, E78.2, N92.6, M54.50, M54.16, O09.90, and R05.9 are covered diagnoses for the procedures 90791, 90832, and G2211. Frequency, age (46 years old), and place of service (telehealth) are compliant with coverage determinations.",
        "status": "Pass"
      },
      "suggestions_for_fixing_issues_report": {
        "suggestions": [
          "Since the provider's signature is missing, ensure the provider signs the document before submission.",
          "Since the provider's name is missing, ensure the provider's name is added to the document before submission.",
          "Since the patient and provider locations are not specified for the telehealth visit, append documentation specifying both the patient and provider locations during the telehealth encounter.",
          "Consider adding CPT code 90785 if communication difficulties were present during the session, as indicated in the note. Ensure documentation supports the use of this code.",
          "Consider adding CPT code 90837 if the psychotherapy time was greater than 53 minutes. The documentation states that the total time spent with the patient was 32 minutes, and the total time spent in psychotherapy was 16 minutes. If the psychotherapy time was greater than 53 minutes, add CPT code 90837.",
          "Consider adding CPT code 99495 or 99496 for Chronic Care Management (CCM) services if the patient had agreed to enrollment. However, the patient declined enrollment, so these codes should not be added.",
          "Consider adding modifier 95 to CPT codes 90791 and 90832 to indicate that the services were provided via telehealth."
        ]
      }
    },
    "citations": {}
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
content-type
string
required

Content type of the patient chart file (e.g., 'application/pdf', 'image/jpeg', 'text/plain')

​
content-disposition
string

Content disposition header with filename parameter (e.g., 'attachment; filename="patient-chart.pdf"')

Query Parameters

​
generate_coding_report
boolean
default:true

Whether to generate coding report (default: true)

​
generate_time_based_requirements_report
boolean
default:true

Whether to generate time-based requirements report (default: true)

​
generate_telehealth_documentation_report
boolean
default:true

Whether to generate telehealth documentation report (default: true)

​
generate_documentation_discrepancy_report
boolean
default:true

Whether to generate documentation discrepancy report (default: true)

​
generate_authentication_report
boolean
default:true

Whether to generate authentication report (default: true)

​
generate_diagnosis_procedure_report_alignment
boolean
default:true

Whether to generate diagnosis-procedure alignment report (default: true)

​
generate_modifier_bundling_report
boolean
default:true

Whether to generate modifier bundling report (default: true)

​
generate_ncd_lcd_analysis
boolean
default:true

Whether to generate NCD/LCD analysis report (default: true)

​
generate_suggestions_for_fixing_issues_report
boolean
default:true

Whether to generate suggestions for fixing issues report (default: true)

Body

Raw content of the patient chart document to be analyzed

Binary content of a PDF document

Response

Patient chart analysis completed successfully

​
success
boolean

Indicates if the analysis was successful

​
analysis_result
object

Comprehensive analysis results