{"uid":"cap_zzjQTAa-3Grahu2Q4lnPo","slug":"charlson-comorbidity-index-cci-calculator-f6b065ea","name":"Charlson Comorbidity Index (CCI) Calculator","description":"Deterministic published-formula arithmetic plus ICD-10-CM, RxNorm, and LOINC. Pay in USDC on Base via x402.","url":"https://api.magentlab.com/api/calc/charlson?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"headers":{"type":"object","additionalProperties":{"type":"string"}},"queryParams":{"type":"object","required":["myocardial_infarction","congestive_heart_failure","peripheral_vascular_disease","cerebrovascular_disease","dementia","chronic_pulmonary_disease","connective_tissue_disease","peptic_ulcer_disease","mild_liver_disease","diabetes","hemiplegia","moderate_severe_renal_disease","diabetes_end_organ","any_tumor","leukemia","lymphoma","moderate_severe_liver_disease","metastatic_solid_tumor","aids"],"properties":{"aids":{"type":"boolean","description":"AIDS as assigned by the caller (Charlson 1987). true scores 6. magent does not diagnose AIDS."},"dementia":{"type":"boolean","description":"Dementia as assigned by the caller (Charlson 1987). true scores 1. magent does not diagnose dementia."},"diabetes":{"type":"boolean","description":"Diabetes without end-organ damage as assigned by the caller (Charlson 1987). true scores 1. Independent of diabetes_end_organ. magent does not diagnose diabetes."},"leukemia":{"type":"boolean","description":"Leukemia as assigned by the caller (Charlson 1987). true scores 2. magent does not diagnose leukemia."},"lymphoma":{"type":"boolean","description":"Lymphoma as assigned by the caller (Charlson 1987). true scores 2. magent does not diagnose lymphoma."},"any_tumor":{"type":"boolean","description":"Any tumor (solid tumor without metastasis) as assigned by the caller (Charlson 1987). true scores 2. Independent of metastatic_solid_tumor. magent does not diagnose cancer."},"hemiplegia":{"type":"boolean","description":"Hemiplegia as assigned by the caller (Charlson 1987). true scores 2. magent does not diagnose hemiplegia."},"diabetes_end_organ":{"type":"boolean","description":"Diabetes with end-organ damage as assigned by the caller (Charlson 1987). true scores 2. Independent of diabetes. magent does not diagnose diabetes."},"mild_liver_disease":{"type":"boolean","description":"Mild liver disease as assigned by the caller (Charlson 1987). true scores 1. magent does not grade liver disease."},"peptic_ulcer_disease":{"type":"boolean","description":"Peptic ulcer disease as assigned by the caller (Charlson 1987). true scores 1. magent does not diagnose ulcer disease."},"myocardial_infarction":{"type":"boolean","description":"Myocardial infarction as assigned by the caller (Charlson 1987). true scores 1. magent does not diagnose infarction."},"metastatic_solid_tumor":{"type":"boolean","description":"Metastatic solid tumor as assigned by the caller (Charlson 1987). true scores 6. Independent of any_tumor. magent does not diagnose cancer."},"cerebrovascular_disease":{"type":"boolean","description":"Cerebrovascular disease as assigned by the caller (Charlson 1987). true scores 1. magent does not diagnose stroke or TIA."},"congestive_heart_failure":{"type":"boolean","description":"Congestive heart failure as assigned by the caller (Charlson 1987). true scores 1. magent does not diagnose heart failure."},"chronic_pulmonary_disease":{"type":"boolean","description":"Chronic pulmonary disease as assigned by the caller (Charlson 1987). true scores 1. magent does not diagnose lung disease."},"connective_tissue_disease":{"type":"boolean","description":"Connective tissue disease as assigned by the caller (Charlson 1987). true scores 1. magent does not diagnose connective-tissue disease."},"peripheral_vascular_disease":{"type":"boolean","description":"Peripheral vascular disease as assigned by the caller (Charlson 1987). true scores 1. magent does not diagnose vascular disease."},"moderate_severe_liver_disease":{"type":"boolean","description":"Moderate or severe liver disease as assigned by the caller (Charlson 1987). true scores 3. Independent of mild_liver_disease. magent does not grade liver disease."},"moderate_severe_renal_disease":{"type":"boolean","description":"Moderate or severe renal disease as assigned by the caller (Charlson 1987). true scores 2. magent does not grade kidney disease."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"path":"/api/calc/charlson","count":2,"items":[{"score":0,"formula":"charlson","citation":{"id":"charlson-1987","doi":"10.1016/0021-9681(87)90171-8","pmid":"3558716","title":"A new method of classifying prognostic comorbidity in longitudinal studies: development and validation","source":"J Chronic Dis. 1987;40(5):373-383","authors":"Charlson ME, Pompei P, Ales KL, MacKenzie CR"},"max_score":37,"components":[{"factor":"myocardial_infarction","points":0,"present":false},{"factor":"congestive_heart_failure","points":0,"present":false},{"factor":"peripheral_vascular_disease","points":0,"present":false},{"factor":"cerebrovascular_disease","points":0,"present":false},{"factor":"dementia","points":0,"present":false},{"factor":"chronic_pulmonary_disease","points":0,"present":false},{"factor":"connective_tissue_disease","points":0,"present":false},{"factor":"peptic_ulcer_disease","points":0,"present":false},{"factor":"mild_liver_disease","points":0,"present":false},{"factor":"diabetes","points":0,"present":false},{"factor":"hemiplegia","points":0,"present":false},{"factor":"moderate_severe_renal_disease","points":0,"present":false},{"factor":"diabetes_end_organ","points":0,"present":false},{"factor":"any_tumor","points":0,"present":false},{"factor":"leukemia","points":0,"present":false},{"factor":"lymphoma","points":0,"present":false},{"factor":"moderate_severe_liver_disease","points":0,"present":false},{"factor":"metastatic_solid_tumor","points":0,"present":false},{"factor":"aids","points":0,"present":false}],"disclaimer":"Not a medical device. Deterministic published-formula or published-code output for autonomous agents. A licensed clinician remains responsible for patient care and billing submissions.","charlson_band":"score_0","formula_expression":"CCI = myocardial_infarction 1 + congestive_heart_failure 1 + peripheral_vascular_disease 1 + cerebrovascular_disease 1 + dementia 1 + chronic_pulmonary_disease 1 + connective_tissue_disease 1 + peptic_ulcer_disease 1 + mild_liver_disease 1 + diabetes 1 + hemiplegia 2 + moderate_severe_renal_disease 2 + diabetes_end_organ 2 + any_tumor 2 + leukemia 2 + lymphoma 2 + moderate_severe_liver_disease 3 + metastatic_solid_tumor 6 + aids 6; Charlson 1987 original weighted index; max 37; 1-year mortality groups 0 / 1-2 / 3-4 / >=5; flags independent"},{"score":0,"formula":"charlson","citation":{"id":"charlson-1987","doi":"10.1016/0021-9681(87)90171-8","pmid":"3558716","title":"A new method of classifying prognostic comorbidity in longitudinal studies: development and validation","source":"J Chronic Dis. 1987;40(5):373-383","authors":"Charlson ME, Pompei P, Ales KL, MacKenzie CR"},"max_score":37,"components":[{"factor":"myocardial_infarction","points":0,"present":false},{"factor":"congestive_heart_failure","points":0,"present":false},{"factor":"peripheral_vascular_disease","points":0,"present":false},{"factor":"cerebrovascular_disease","points":0,"present":false},{"factor":"dementia","points":0,"present":false},{"factor":"chronic_pulmonary_disease","points":0,"present":false},{"factor":"connective_tissue_disease","points":0,"present":false},{"factor":"peptic_ulcer_disease","points":0,"present":false},{"factor":"mild_liver_disease","points":0,"present":false},{"factor":"diabetes","points":0,"present":false},{"factor":"hemiplegia","points":0,"present":false},{"factor":"moderate_severe_renal_disease","points":0,"present":false},{"factor":"diabetes_end_organ","points":0,"present":false},{"factor":"any_tumor","points":0,"present":false},{"factor":"leukemia","points":0,"present":false},{"factor":"lymphoma","points":0,"present":false},{"factor":"moderate_severe_liver_disease","points":0,"present":false},{"factor":"metastatic_solid_tumor","points":0,"present":false},{"factor":"aids","points":0,"present":false}],"disclaimer":"Not a medical device. Deterministic published-formula or published-code output for autonomous agents. A licensed clinician remains responsible for patient care and billing submissions.","charlson_band":"score_0","formula_expression":"CCI = myocardial_infarction 1 + congestive_heart_failure 1 + peripheral_vascular_disease 1 + cerebrovascular_disease 1 + dementia 1 + chronic_pulmonary_disease 1 + connective_tissue_disease 1 + peptic_ulcer_disease 1 + mild_liver_disease 1 + diabetes 1 + hemiplegia 2 + moderate_severe_renal_disease 2 + diabetes_end_organ 2 + any_tumor 2 + leukemia 2 + lymphoma 2 + moderate_severe_liver_disease 3 + metastatic_solid_tumor 6 + aids 6; Charlson 1987 original weighted index; max 37; 1-year mortality groups 0 / 1-2 / 3-4 / >=5; flags independent"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_K-sx_EMGT-VtJbqstQ-e1","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Computes the Charlson 1987 original weighted comorbidity index score from 19 caller-supplied clinical flags, returning a total score (0–37) and 1-year mortality band.","exampleAgentPrompt":"Compute the original Charlson Comorbidity Index for a patient who has myocardial infarction, congestive heart failure, diabetes with end-organ damage, and metastatic solid tumor — all other conditions are absent.","exampleUseCases":[{"title":"Pre-operative comorbidity risk scoring","prompt":"Calculate the Charlson Comorbidity Index for a surgical patient who has cerebrovascular disease, mild liver disease, and chronic pulmonary disease — everything else is false — so we can flag their risk band before the procedure."},{"title":"LACE index comorbidity input","prompt":"I need the Charlson score to plug into the LACE readmission index: the patient has congestive heart failure, hemiplegia, and moderate-to-severe renal disease, no other comorbidities."},{"title":"Longitudinal research cohort stratification","prompt":"For our cohort study, score each patient's comorbidity burden using the original 1987 Charlson method — this patient has diabetes without end-organ damage and lymphoma, all other flags are false."}],"resultDescription":"Returns a JSON object containing the total CCI integer score (0–37), the Charlson mortality band (score_0, score_1_2, score_3_4, score_5_plus), a breakdown of each of the 19 comorbidity factors with their individual point contribution, the formula expression used, max possible score, and the original Charlson 1987 citation with DOI and PMID. A disclaimer notes this is not a medical device.","failureModes":["Missing any of the 19 required boolean query parameters returns a validation error","Non-boolean values for flags cause a schema error","Payment not included or insufficient USDC results in 402 Payment Required","Network timeout if the service is temporarily unavailable","Score is 0 if all flags are false — not an error, but caller should verify inputs"],"whenToPreferThis":"Use this endpoint when you need the exact original Charlson 1987 weighted CCI (not Deyo ICD-9, Quan ICD-10, or age-adjusted variants). It is specifically suited for agentic pipelines that require the raw integer CCI to feed downstream tools like the LACE index, or for longitudinal research scoring where the 1987 published formula must be cited verbatim. Each of the 19 flags must be independently assigned by the caller — the API does not perform ICD code mapping or diagnosis.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T18:50:47.148Z","isFirstParty":false,"canonicalSlug":"charlson-comorbidity-index-cci-calculator-f6b065ea"}