{"uid":"cap_-WpIQS9E9n_Rsfgcq4VlZ","slug":"acc-aha-heart-failure-stage-calculator-yancy-2013-536665ae","name":"ACC/AHA Heart Failure Stage Calculator (Yancy 2013)","description":"2013 ACCF/AHA heart-failure stages (Yancy) from four caller flags: high risk for HF, structural heart disease, prior or current HF symptoms, and refractory specialized care. Returns hf_stage A, B, C, D, or not_staged. Progressive and inviolate: D first, then C, B, A, else not_staged. Not NYHA class and not a diagnosis. magent does not examine the patient or read an echocardiogram.","url":"https://api.magentlab.com/api/calc/acc_aha_hf","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":["high_risk_for_hf","structural_heart_disease","hf_symptoms_prior_or_current","refractory_hf_specialized"],"properties":{"high_risk_for_hf":{"type":"boolean","description":"High risk for HF without structural heart disease or HF symptoms (Yancy 2013 stage A assignment). true or false as assigned by the caller. magent does not examine the patient."},"structural_heart_disease":{"type":"boolean","description":"Structural heart disease as assigned by the caller (Yancy 2013 stage B or C). true or false. magent does not read an echocardiogram."},"refractory_hf_specialized":{"type":"boolean","description":"Refractory HF requiring specialized interventions as assigned by the caller (Yancy 2013 stage D). true or false. magent does not examine the patient."},"hf_symptoms_prior_or_current":{"type":"boolean","description":"Prior or current symptoms of HF as assigned by the caller (Yancy 2013 stage C). true or false. magent does not examine the patient."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"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_ZhGNZZpwERTLoPZblivUm","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":"Assigns the 2013 ACCF/AHA heart failure stage (A, B, C, or D) from four boolean clinical flags provided by the caller, following the Yancy 2013 progressive staging algorithm.","exampleAgentPrompt":"Stage this patient using the 2013 ACC/AHA Yancy heart failure criteria: they have structural heart disease and prior HF symptoms, but are not high risk without disease and do not require refractory specialized care.","exampleUseCases":[{"title":"EHR clinical decision support staging","prompt":"I have a patient with documented structural heart disease but no current or prior HF symptoms and no refractory care needs — not just high-risk. What is their ACC/AHA Yancy 2013 heart failure stage?"},{"title":"Refractory HF triage classification","prompt":"This patient requires specialized interventions for refractory heart failure. They also have structural heart disease and current symptoms. What stage are they under the 2013 ACCF/AHA Yancy framework?"},{"title":"High-risk patient with no structural disease","prompt":"A patient is flagged as high risk for heart failure but has no structural heart disease, no HF symptoms, and does not need refractory care. Can you assign their ACC/AHA HF stage using the Yancy 2013 criteria?"}],"resultDescription":"Returns a single hf_stage field with one of five values: A (high risk, no structural disease or symptoms), B (structural disease, no symptoms), C (structural disease with prior or current symptoms), D (refractory HF requiring specialized care), or not_staged if none of the flags qualify under the algorithm. Staging is applied in strict D→C→B→A priority order.","failureModes":["Missing required boolean flags returns a validation error","All flags false returns not_staged rather than an error","Caller-supplied flags that are clinically incorrect will produce a logically consistent but medically wrong stage — the API does not validate clinical accuracy","Non-boolean values for flag fields will fail schema validation"],"whenToPreferThis":"Use this endpoint when you need a fast, deterministic mapping from four pre-assessed clinical boolean flags to a 2013 ACCF/AHA heart failure stage per Yancy. Prefer it over manual lookup tables or LLM reasoning when you need consistent, guideline-adherent staging logic in a pipeline. Not appropriate if you need NYHA functional class, a diagnosis, or if you lack pre-assessed clinical flags — this endpoint does not examine patients or interpret echocardiograms.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:48:58.558Z","isFirstParty":false}