{"uid":"cap_okEVbQohMZS54Wc5ku-kU","slug":"magent-modified-hoehn-and-yahr-stage-lookup-f959ae3b","name":"Magent Modified Hoehn and Yahr Stage Lookup","description":"Goetz 2004 modified Hoehn and Yahr stage (Table 1). Caller-assigned tokens 1.0, 1.5, 2.0, 2.5, 3.0, 4.0, or 5.0 with the published description. No stage 0. Not the original integer-only 1-5 scale, not UPDRS, not a diagnosis, and not an outcome measure. magent does not examine the patient. Not a medical device.","url":"https://api.magentlab.com/api/calc/modified_hoehn_yahr","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":["hy_stage"],"properties":{"hy_stage":{"type":"string","description":"Goetz 2004 Table 1 modified Hoehn and Yahr stage as assigned by the caller: 1.0, 1.5, 2.0, 2.5, 3.0, 4.0, or 5.0 (exact tokens; reject 1, 3, 0, 0.5, 2.5.0). 1.0 unilateral only; 1.5 unilateral and axial; 2.0 bilateral without impairment of balance; 2.5 mild bilateral with recovery on pull test; 3.0 mild to moderate bilateral with some postural instability, physically independent; 4.0 severe disability, still able to walk or stand unassisted; 5.0 wheelchair bound or bedridden unless aided. No stage 0. Not the original integer-only 1-5 scale. Not UPDRS. 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_fbZyQ1FGwHfxiCBEqDZUY","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":"Returns the published Goetz 2004 Table 1 description for a caller-assigned modified Hoehn and Yahr Parkinson's disease stage (1.0, 1.5, 2.0, 2.5, 3.0, 4.0, or 5.0).","exampleAgentPrompt":"Look up the Goetz 2004 modified Hoehn and Yahr stage description for stage 2.5 — I need the published clinical text for that token.","exampleUseCases":[{"title":"Parkinson's staging documentation assistant","prompt":"A patient's chart lists modified Hoehn and Yahr stage 3.0 — can you pull the official Goetz 2004 Table 1 description for that stage so I can include it in the clinical note?"},{"title":"Research data enrichment pipeline","prompt":"I have a dataset of Parkinson's patients with their modified HY stage tokens; can you retrieve the Goetz 2004 published description for stage 4.0 so I can annotate the records?"},{"title":"Clinical decision support staging review","prompt":"We're reviewing a patient with mild bilateral Parkinson's and some postural instability who is still physically independent — which modified Hoehn and Yahr stage is that, and what does the Goetz 2004 text say for stage 3.0?"}],"resultDescription":"The endpoint returns the official Goetz 2004 Table 1 description text corresponding to the submitted modified Hoehn and Yahr stage token, confirming the stage label and its published clinical definition (e.g. 'mild to moderate bilateral with some postural instability, physically independent' for stage 3.0).","failureModes":["Invalid stage token (e.g. '0', '1', '3' as integer, '0.5', '6.0') — endpoint rejects non-enumerated values","Stage 0 submitted — not part of the modified scale, will be rejected","Original Hoehn and Yahr integer scale values (1-5 without decimals) not accepted","Missing required hy_stage query parameter returns an error","Network or payment authorization failure (x402 payment required)"],"whenToPreferThis":"Use this endpoint when you need the authoritative Goetz 2004 Table 1 description for a specific modified Hoehn and Yahr stage token (1.0, 1.5, 2.0, 2.5, 3.0, 4.0, 5.0). Prefer it over manual lookup when building clinical documentation tools, annotating research datasets, or validating stage tokens against the published scale. Do not use for the original integer-only 1–5 Hoehn and Yahr scale, UPDRS scoring, diagnosis, or patient examination — this is a text lookup only and not a medical device.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T07:11:43.941Z","isFirstParty":false}