{"uid":"cap_la0gmW8L9Kxbnv0KMZqB9","slug":"magent-villalta-scale-kahn-2009-pts-calculator-1ffe4ac5","name":"magent Villalta Scale (Kahn 2009) PTS Calculator","description":"Kahn 2009 Villalta scale (ISTH SSC): five caller-assigned symptoms and six signs, each 0-3 (none/mild/moderate/severe), summed 0-33. Venous ulcer is a separate boolean and is not added as 15 points. PTS if score ≥5 or ulcer; bands none 0-4 (no ulcer), mild 5-9, moderate 10-14, severe if ≥15 or ulcer. magent does not examine the limb. Not CEAP, not VCSS, not Ginsberg PTS.","url":"https://api.magentlab.com/api/calc/villalta","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":["pain","cramps","heaviness","pruritus","paresthesia","pretibial_edema","skin_induration","hyperpigmentation","venous_ectasia","redness","pain_on_calf_compression","ulcer"],"properties":{"pain":{"type":"integer","description":"Caller-assigned Kahn 2009 Villalta symptom pain (integer 0-3: 0 none, 1 mild, 2 moderate, 3 severe). magent does not examine the limb."},"ulcer":{"type":"boolean","description":"Caller-assigned venous ulcer (true or false). Presence classifies PTS as severe (Kahn 2009) and does not add 15 to the numeric score. magent does not examine the limb."},"cramps":{"type":"integer","description":"Caller-assigned Kahn 2009 Villalta symptom cramps (integer 0-3: 0 none, 1 mild, 2 moderate, 3 severe). magent does not examine the limb."},"redness":{"type":"integer","description":"Caller-assigned Kahn 2009 Villalta sign redness (integer 0-3: 0 none, 1 mild, 2 moderate, 3 severe). magent does not examine the limb."},"pruritus":{"type":"integer","description":"Caller-assigned Kahn 2009 Villalta symptom pruritus (integer 0-3: 0 none, 1 mild, 2 moderate, 3 severe). magent does not examine the limb."},"heaviness":{"type":"integer","description":"Caller-assigned Kahn 2009 Villalta symptom heaviness (integer 0-3: 0 none, 1 mild, 2 moderate, 3 severe). magent does not examine the limb."},"paresthesia":{"type":"integer","description":"Caller-assigned Kahn 2009 Villalta symptom paresthesia (integer 0-3: 0 none, 1 mild, 2 moderate, 3 severe). magent does not examine the limb."},"venous_ectasia":{"type":"integer","description":"Caller-assigned Kahn 2009 Villalta sign venous ectasia (integer 0-3: 0 none, 1 mild, 2 moderate, 3 severe). magent does not examine the limb."},"pretibial_edema":{"type":"integer","description":"Caller-assigned Kahn 2009 Villalta sign pretibial edema (integer 0-3: 0 none, 1 mild, 2 moderate, 3 severe). magent does not examine the limb."},"skin_induration":{"type":"integer","description":"Caller-assigned Kahn 2009 Villalta sign skin induration (integer 0-3: 0 none, 1 mild, 2 moderate, 3 severe). magent does not examine the limb."},"hyperpigmentation":{"type":"integer","description":"Caller-assigned Kahn 2009 Villalta sign hyperpigmentation (integer 0-3: 0 none, 1 mild, 2 moderate, 3 severe). magent does not examine the limb."},"pain_on_calf_compression":{"type":"integer","description":"Caller-assigned Kahn 2009 Villalta sign pain on calf compression (integer 0-3: 0 none, 1 mild, 2 moderate, 3 severe). magent does not examine the limb."}}}},"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_1SKS1u6ZHIi5elwZatkiR","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 Kahn 2009 Villalta scale score for post-thrombotic syndrome (PTS) from five caller-assigned symptoms and six signs, returning total score, PTS classification, and severity band.","exampleAgentPrompt":"Calculate the Kahn 2009 Villalta score for a patient with pain 2, cramps 1, heaviness 2, pruritus 0, paresthesia 1, pretibial edema 2, skin induration 1, hyperpigmentation 1, venous ectasia 0, redness 0, pain on calf compression 1, and no venous ulcer — tell me the total score and whether they have PTS and how severe.","exampleUseCases":[{"title":"DVT follow-up PTS screening","prompt":"My DVT patient at their 6-month follow-up has pain 1, cramps 2, heaviness 2, pruritus 0, paresthesia 1, pretibial edema 1, skin induration 0, hyperpigmentation 1, venous ectasia 1, redness 0, pain on calf compression 1, no ulcer — compute the Villalta score and tell me if they meet criteria for post-thrombotic syndrome."},{"title":"Severe PTS with venous ulcer","prompt":"Score this patient on the Villalta scale: pain 3, cramps 2, heaviness 3, pruritus 1, paresthesia 2, pretibial edema 3, skin induration 2, hyperpigmentation 2, venous ectasia 1, redness 1, pain on calf compression 2, and they have a venous ulcer — what's the total and severity band?"},{"title":"Borderline PTS rule-out","prompt":"A patient post-DVT has very mild symptoms: pain 1, cramps 0, heaviness 1, pruritus 0, paresthesia 0, pretibial edema 1, skin induration 0, hyperpigmentation 0, venous ectasia 0, redness 0, pain on calf compression 0, no ulcer — run the Kahn 2009 Villalta calculator and tell me if their score crosses the PTS threshold of 5."}],"resultDescription":"Returns the numeric Villalta total score (0–33, summing all eleven items), the binary PTS classification (present if score ≥5 or venous ulcer is true), and the severity band: none (0–4, no ulcer), mild (5–9), moderate (10–14), severe (≥15 or venous ulcer present). The venous ulcer flag is not added as 15 points to the numeric score but independently forces the severe classification.","failureModes":["Missing required query parameter returns validation error","Integer values outside 0–3 range rejected","Boolean ulcer field passed as non-boolean causes parse error","All-zero inputs with ulcer=false returns score 0 with no PTS (none band)"],"whenToPreferThis":"Use this endpoint when you need to apply the specific Kahn 2009 / ISTH SSC Villalta scale to classify post-thrombotic syndrome severity after deep vein thrombosis. Choose this over CEAP, VCSS, or Ginsberg PTS criteria — this endpoint implements only the Kahn 2009 Villalta formulation and explicitly is not those alternatives. Ideal for clinical decision support pipelines where a caller (clinician or structured assessment form) supplies the pre-assessed scores for each of the five symptoms and six signs.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T13:08:20.841Z","isFirstParty":false}