{"uid":"cap_Q-Q_tl2nBggwWYSG3FG2S","slug":"magent-phq-9-depression-severity-calculator-5ea9e4ff","name":"magent PHQ-9 Depression Severity Calculator","description":"Kroenke 2001 PHQ-9 from nine caller-assigned DSM-IV depression items as integers 0-3 (0 not at all, 1 several days, 2 more than half the days, 3 nearly every day). magent does not interpret the items. Total 0-27. Severity: 0-4 none_minimal, 5-9 mild, 10-14 moderate, 15-19 moderately_severe, 20-27 severe. Returns screen_ge_10 (score ≥10; this paper 88% sensitivity and 88% specificity for major depression). Not a diagnosis, not a treatment order, not GAD-7, and not PHQ-2/PHQ-8.","url":"https://api.magentlab.com/api/calc/phq_9","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":["anhedonia","depressed","sleep","energy","appetite","failure","concentration","psychomotor","self_harm"],"properties":{"sleep":{"type":"integer","description":"Caller-assigned Kroenke 2001 PHQ-9 item 3 (integer 0-3): trouble falling or staying asleep, or sleeping too much. magent does not interpret the item."},"energy":{"type":"integer","description":"Caller-assigned Kroenke 2001 PHQ-9 item 4 (integer 0-3): feeling tired or having little energy. magent does not interpret the item."},"failure":{"type":"integer","description":"Caller-assigned Kroenke 2001 PHQ-9 item 6 (integer 0-3): feeling bad about yourself — a failure, or having let yourself or your family down. magent does not interpret the item."},"appetite":{"type":"integer","description":"Caller-assigned Kroenke 2001 PHQ-9 item 5 (integer 0-3): poor appetite or overeating. magent does not interpret the item."},"anhedonia":{"type":"integer","description":"Caller-assigned Kroenke 2001 PHQ-9 item 1 (integer 0-3): little interest or pleasure in doing things (0 not at all, 1 several days, 2 more than half the days, 3 nearly every day). magent does not interpret the item."},"depressed":{"type":"integer","description":"Caller-assigned Kroenke 2001 PHQ-9 item 2 (integer 0-3): feeling down, depressed, or hopeless. magent does not interpret the item."},"self_harm":{"type":"integer","description":"Caller-assigned Kroenke 2001 PHQ-9 item 9 (integer 0-3): thoughts that you would be better off dead, or of hurting yourself in some way. magent does not interpret the item."},"psychomotor":{"type":"integer","description":"Caller-assigned Kroenke 2001 PHQ-9 item 8 (integer 0-3): moving or speaking so slowly that other people could have noticed, or being so fidgety or restless that you have been moving around a lot more than usual. magent does not interpret the item."},"concentration":{"type":"integer","description":"Caller-assigned Kroenke 2001 PHQ-9 item 7 (integer 0-3): trouble concentrating on things such as reading or watching television. magent does not interpret the item."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"path":"/api/calc/phq_9","count":2,"items":[{"score":0,"formula":"phq_9","citation":{"id":"kroenke-2001","doi":"10.1046/j.1525-1497.2001.016009606.x","pmid":"11556941","title":"The PHQ-9: validity of a brief depression severity measure","source":"J Gen Intern Med. 2001;16(9):606-613","authors":"Kroenke K, Spitzer RL, Williams JBW"},"severity":"none_minimal","max_score":27,"components":[{"value":0,"factor":"anhedonia","points":0,"present":true},{"value":0,"factor":"depressed","points":0,"present":true},{"value":0,"factor":"sleep","points":0,"present":true},{"value":0,"factor":"energy","points":0,"present":true},{"value":0,"factor":"appetite","points":0,"present":true},{"value":0,"factor":"failure","points":0,"present":true},{"value":0,"factor":"concentration","points":0,"present":true},{"value":0,"factor":"psychomotor","points":0,"present":true},{"value":0,"factor":"self_harm","points":0,"present":true}],"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.","screen_ge_10":false,"formula_expression":"PHQ-9 = anhedonia + depressed + sleep + energy + appetite + failure + concentration + psychomotor + self_harm; each caller-assigned 0-3; max 27"},{"score":0,"formula":"phq_9","citation":{"id":"kroenke-2001","doi":"10.1046/j.1525-1497.2001.016009606.x","pmid":"11556941","title":"The PHQ-9: validity of a brief depression severity measure","source":"J Gen Intern Med. 2001;16(9):606-613","authors":"Kroenke K, Spitzer RL, Williams JBW"},"severity":"none_minimal","max_score":27,"components":[{"value":0,"factor":"anhedonia","points":0,"present":true},{"value":0,"factor":"depressed","points":0,"present":true},{"value":0,"factor":"sleep","points":0,"present":true},{"value":0,"factor":"energy","points":0,"present":true},{"value":0,"factor":"appetite","points":0,"present":true},{"value":0,"factor":"failure","points":0,"present":true},{"value":0,"factor":"concentration","points":0,"present":true},{"value":0,"factor":"psychomotor","points":0,"present":true},{"value":0,"factor":"self_harm","points":0,"present":true}],"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.","screen_ge_10":false,"formula_expression":"PHQ-9 = anhedonia + depressed + sleep + energy + appetite + failure + concentration + psychomotor + self_harm; each caller-assigned 0-3; max 27"}]}},"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_BcVfCF2smILUXF8GyPSi3","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 Kroenke 2001 PHQ-9 total score (0-27), severity band, and screen_ge_10 flag from nine caller-supplied DSM-IV symptom ratings (0-3 each).","exampleAgentPrompt":"Score a PHQ-9 for me: anhedonia 2, depressed 3, sleep 2, energy 2, appetite 1, failure 1, concentration 2, psychomotor 0, self-harm 1 — give me the total score, severity band, and whether it screens positive (≥10).","exampleUseCases":[{"title":"Telehealth intake depression screen","prompt":"A patient just completed a telehealth intake and rated their PHQ-9 symptoms as: anhedonia 2, depressed 2, sleep 3, energy 2, appetite 1, failure 1, concentration 2, psychomotor 1, self-harm 0. Can you calculate their PHQ-9 total and tell me the severity category and whether they screen positive?"},{"title":"EHR clinical workflow automation","prompt":"I'm building an automated clinical notes assistant. Given these PHQ-9 item scores — anhedonia 1, depressed 1, sleep 0, energy 1, appetite 0, failure 0, concentration 1, psychomotor 0, self-harm 0 — compute the PHQ-9 total score, severity label, and the screen_ge_10 flag so I can populate the EHR record."},{"title":"Research data pipeline PHQ-9 batch prep","prompt":"For a study participant who rated themselves: anhedonia 3, depressed 3, sleep 3, energy 3, appetite 2, failure 2, concentration 2, psychomotor 2, self-harm 1 — what is their PHQ-9 score, severity classification, and does the screen_ge_10 flag come back true? Include the Kroenke 2001 citation in the output."}],"resultDescription":"Returns a JSON object with: total PHQ-9 score (integer 0-27), severity string (none_minimal, mild, moderate, moderately_severe, or severe), screen_ge_10 boolean (true if score ≥10, with ~88% sensitivity and specificity for major depression per the citation), a per-item component breakdown showing each factor's value and points, the Kroenke 2001 academic citation (DOI, PMID, journal), the formula expression, and a disclaimer that this is not a medical device and a licensed clinician retains responsibility for patient care.","failureModes":["Missing any of the nine required query parameters returns an error — all nine items (anhedonia, depressed, sleep, energy, appetite, failure, concentration, psychomotor, self_harm) must be supplied","Integer values outside 0-3 range may cause validation errors or unexpected results","Payment failure via x402 protocol will block the response (endpoint costs $0.005 USDC per call)","Passing non-integer (e.g. float or string) values for symptom items will likely cause a schema error"],"whenToPreferThis":"Choose this endpoint when you need a deterministic, citable, machine-readable PHQ-9 score computation with severity banding and the screen_ge_10 flag for autonomous agent workflows, EHR integrations, or clinical documentation pipelines. It is not appropriate for GAD-7, PHQ-2, PHQ-8, or any other instrument. Prefer it over hand-coding PHQ-9 arithmetic when you need the full Kroenke 2001 citation, per-item component breakdown, and structured disclaimer in the response payload.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:40:19.894Z","isFirstParty":false}