Skip to main content
Use this endpoint to predict structured medical codes (e.g., ICD-10-CM) from free-text input such as transcripts, summaries, or encounter notes.
1

Authentication

See details here
2

Calling the Endpoint to Predict Codes

Endpoint:
POST https://api.{environment}.corti.app/v2/tools/coding/
Headers:
  • Authorization: Bearer <access_token>
  • Tenant-Name: <tenant-name>
  • Content-Type: application/json
Request Example:
{
"system": [
    "icd10cm"
],
"context": [
    {
    "type": "text",
    "text": "Patient is a 58-year-old male with history of T2DM, controlled with metformin 1000 mg BID, low-carbohydrate diet, and regular exercise (walks 5x/week). Home glucose readings 90–110 mg/dL fasting, occasional postprandial up to 130 mg/dL. No hypoglycemic symptoms.\nReview of Systems (ROS):\nConstitutional: No fatigue or weight changes\nCardiovascular: No chest pain, palpitations, or edema\nRespiratory: No cough or dyspnea\nGI: No nausea or abdominal pain\nGU: No polyuria or dysuria\nEndocrine: No polydipsia, polyphagia, or heat/cold intolerance\n\nObjective:\nVital Signs: BP 124/76 mmHg, HR 72 bpm, BMI 26.1 kg/m²\nPhysical Exam:\nGeneral: Well-appearing, no distress\nHEENT: Normal\nNeck: No thyromegaly\nCardiac: RRR, no murmurs\nLungs: Clear bilaterally\nAbdomen: Soft, non-tender\nExtremities: No edema; monofilament sensation intact\nLabs (today): A1C 6.4%; LDL 82 mg/dL; eGFR 92 mL/min/1.73m²; microalbumin/Cr ratio normal\n\nAssessment:\n1. Type 2 Diabetes Mellitus, well controlled – Excellent control with current regimen. No complications.\n2. Preventive Health Maintenance – Colonoscopy up to date; influenza vaccine today; pneumococcal and COVID-19 boosters current.\n\nPlan:\nContinue metformin 1000 mg BID, maintain diet/exercise routine.\nRepeat labs in 6 months.\nAnnual retinal and foot exams.\nFollow-up in 1 year for wellness or sooner if issues arise."
    }
],
"maxCandidates": 5
}
3

Server Response

{
"codes": [
{
    "system": "icd10cm",
    "code": "E119",
    "display": "Type 2 diabetes mellitus without complications",
    "evidences": [
        {
            "contextIndex": 0,
            "text": "Type 2 Diabetes Mellitus, well controlled – Excellent control with current regimen."
        },
        {
            "contextIndex": 0,
            "text": "No complications."
        }
    ]
},
{
    "system": "icd10cm",
    "code": "Z6826",
    "display": "Body mass index (BMI) 26.0-26.9, adult",
    "evidences": [
        {
            "contextIndex": 0,
            "text": "Vital Signs: BP 124/76 mmHg, HR 72 bpm, BMI 26."
        },
        {
            "contextIndex": 0,
            "text": "1 kg/m²"
        },
        {
            "contextIndex": 0,
            "text": "Physical Exam:"
        },
        {
            "contextIndex": 0,
            "text": "4%; LDL 82 mg/dL; eGFR 92 mL/min/1."
        }
    ]
},
{
    "system": "icd10cm",
    "code": "Z0000",
    "display": "Encounter for general adult medical examination without abnormal findings",
    "evidences": [
        {
            "contextIndex": 0,
            "text": "Reason for Visit: Annual wellness examination and follow-up for Type 2 Diabetes Mellitus (T2DM)"
        },
        {
            "contextIndex": 0,
            "text": "Date: 10/24/2025"
        },
        {
            "contextIndex": 0,
            "text": "”"
        },
        {
            "contextIndex": 0,
            "text": "Feeling well."
        }
    ]
}
],
"candidates": [
    {
        "system": "icd10cm",
        "code": "E782",
        "display": "Mixed hyperlipidemia",
        "evidences": [
            {
                "contextIndex": 0,
                "text": "”"
            },
            {
                "contextIndex": 0,
                "text": "Patient with 8-year history of T2DM, controlled with metformin 1000 mg BID, low-carbohydrate diet, and regular exercise (walks 5x/week)."
            },
            {
                "contextIndex": 0,
                "text": "Clinical Note 0"
            },
            {
                "contextIndex": 0,
                "text": "History of Present Illness (HPI):"
            }
        ]
    },
    {
        "system": "icd10cm",
        "code": "Z794",
        "display": "Long term (current) use of insulin",
        "evidences": [
            {
                "contextIndex": 0,
                "text": "Reason for Visit: Annual wellness examination and follow-up for Type 2 Diabetes Mellitus (T2DM)"
            },
            {
                "contextIndex": 0,
                "text": "Type 2 Diabetes Mellitus, well controlled – Excellent control with current regimen."
            }
        ]
    },
    {
        "system": "icd10cm",
        "code": "E1165",
        "display": "Type 2 diabetes mellitus with hyperglycemia",
        "evidences": [
            {
                "contextIndex": 0,
                "text": "Reason for Visit: Annual wellness examination and follow-up for Type 2 Diabetes Mellitus (T2DM)"
            },
            {
                "contextIndex": 0,
                "text": "Type 2 Diabetes Mellitus, well controlled – Excellent control with current regimen."
            }
        ]
    },
    {
        "system": "icd10cm",
        "code": "E1142",
        "display": "Type 2 diabetes mellitus with diabetic polyneuropathy",
        "evidences": [
            {
                "contextIndex": 0,
                "text": "Reason for Visit: Annual wellness examination and follow-up for Type 2 Diabetes Mellitus (T2DM)"
            },
            {
                "contextIndex": 0,
                "text": "Type 2 Diabetes Mellitus, well controlled – Excellent control with current regimen."
            }
        ]
    },
    {
        "system": "icd10cm",
        "code": "E1122",
        "display": "Type 2 diabetes mellitus with diabetic chronic kidney disease",
        "evidences": [
            {
                "contextIndex": 0,
                "text": "Type 2 Diabetes Mellitus, well controlled – Excellent control with current regimen."
            },
            {
                "contextIndex": 0,
                "text": "No complications."
            },
            {
                "contextIndex": 0,
                "text": "Clinical Note 0"
            }
        ]
    }
],
"usageInfo": {
    "creditsConsumed": 0.05576
}
}
4

Next Steps

  1. Present code predictions to user for validation or next step in the EHR workflow.
  2. Store predicted codes with interaction results.
  3. Optionally re-rank or filter predictions based on local clinical rules or billing guidelines.