# Geriatric Depression Scale 15-item (GDS-15) GDS-15 Status: LIVE Price: $0.005 USDC `GET /api/calc/gds_15` HTML: https://magentlab.com/docs/gds-15 Markdown: https://magentlab.com/docs/gds-15.md Not a medical device. Not a diagnosis, dose, or listing recommendation. ## What it computes Sum fifteen Sheikh 1986 GDS-15 yes/no items using that paper's reverse-scoring key and return the published 0-15 total. Does not apply later total-score severity bands. ## When to use When an agent already has Sheikh 1986 GDS-15 yes/no answers (as asked, not pre-scored points) and needs the published total. magent does not interview the patient, diagnose depression, score PHQ-9, score the 30-item GDS, or apply later 0-4/5-9/10+ cutoffs. ## When not to use - Not a medical device and not a depression diagnosis or treatment order. - Each of the fifteen items is a caller-assigned yes/no answering the question as asked. magent does not interview the patient. - This is Sheikh 1986 GDS-15 only (15-item short form; max 15). magent does not score the 30-item GDS or PHQ-9. - Sheikh 1986 published no total-score severity bands. This tool returns score and max_score only. It does not apply later Almeida or website 0-4/5-9/10+ cutoffs. ## Formula ``` GDS-15 = (1 if not satisfied_with_life) + dropped_activities + life_empty + often_bored + (1 if not good_spirits) + afraid_something_bad + (1 if not happy_most_of_time) + often_helpless + prefer_stay_home + more_memory_problems + (1 if not wonderful_to_be_alive) + pretty_worthless + (1 if not full_of_energy) + situation_hopeless + most_people_better_off; Sheikh 1986 15-item short form; each yes/no as asked; reverse-scored items 1, 5, 7, 11, 13; max 15; no total-score severity bands ``` ## Citation [Geriatric Depression Scale (GDS): recent evidence and development of a shorter version](https://doi.org/10.1300/J018v05n01_09) Sheikh JI, Yesavage JA Clin Gerontol. 1986;5(1-2):165-173 DOI: [10.1300/J018v05n01_09](https://doi.org/10.1300/J018v05n01_09) ## Worked example ### No-depression profile Given: `afraid_something_bad=false, dropped_activities=false, full_of_energy=true, good_spirits=true, happy_most_of_time=true, life_empty=false, more_memory_problems=false, most_people_better_off=false, often_bored=false, often_helpless=false, prefer_stay_home=false, pretty_worthless=false, satisfied_with_life=true, situation_hopeless=false, wonderful_to_be_alive=true` 1. satisfied_with_life, good_spirits, happy_most_of_time, wonderful_to_be_alive, and full_of_energy are true (reverse-scored; not scored) 2. the other ten items are false (not scored) 3. Score = 0 (max 15). Sheikh 1986 published no total-score severity band. ### All depression-direction answers Given: `afraid_something_bad=true, dropped_activities=true, full_of_energy=false, good_spirits=false, happy_most_of_time=false, life_empty=true, more_memory_problems=true, most_people_better_off=true, often_bored=true, often_helpless=true, prefer_stay_home=true, pretty_worthless=true, satisfied_with_life=false, situation_hopeless=true, wonderful_to_be_alive=false` 1. satisfied_with_life, good_spirits, happy_most_of_time, wonderful_to_be_alive, and full_of_energy are false (reverse-scored; each scores 1) 2. the other ten items are true (each scores 1) 3. Score = 15 (max 15). No total-score severity band. ## Also searched as - GDS-15 - Geriatric Depression Scale 15-item - Sheikh Yesavage GDS short form - GDS short form - 15-item GDS - Sheikh 1986 GDS - geriatric depression screen ## Parameters - `satisfied_with_life` (boolean, required): Are you basically satisfied with your life? (Sheikh 1986 GDS-15 item 1). true or false as assigned by the caller. false is the depression-direction answer and scores 1. magent does not interview the patient. - `dropped_activities` (boolean, required): Have you dropped many of your activities and interests? (Sheikh 1986 GDS-15 item 2). true or false as assigned by the caller. true is the depression-direction answer and scores 1. magent does not interview the patient. - `life_empty` (boolean, required): Do you feel that your life is empty? (Sheikh 1986 GDS-15 item 3). true or false as assigned by the caller. true is the depression-direction answer and scores 1. magent does not interview the patient. - `often_bored` (boolean, required): Do you often get bored? (Sheikh 1986 GDS-15 item 4). true or false as assigned by the caller. true is the depression-direction answer and scores 1. magent does not interview the patient. - `good_spirits` (boolean, required): Are you in good spirits most of the time? (Sheikh 1986 GDS-15 item 5). true or false as assigned by the caller. false is the depression-direction answer and scores 1. magent does not interview the patient. - `afraid_something_bad` (boolean, required): Are you afraid that something bad is going to happen to you? (Sheikh 1986 GDS-15 item 6). true or false as assigned by the caller. true is the depression-direction answer and scores 1. magent does not interview the patient. - `happy_most_of_time` (boolean, required): Do you feel happy most of the time? (Sheikh 1986 GDS-15 item 7). true or false as assigned by the caller. false is the depression-direction answer and scores 1. magent does not interview the patient. - `often_helpless` (boolean, required): Do you often feel helpless? (Sheikh 1986 GDS-15 item 8). true or false as assigned by the caller. true is the depression-direction answer and scores 1. magent does not interview the patient. - `prefer_stay_home` (boolean, required): Do you prefer to stay at home, rather than going out and doing new things? (Sheikh 1986 GDS-15 item 9). true or false as assigned by the caller. true is the depression-direction answer and scores 1. magent does not interview the patient. - `more_memory_problems` (boolean, required): Do you feel you have more problems with memory than most? (Sheikh 1986 GDS-15 item 10). true or false as assigned by the caller. true is the depression-direction answer and scores 1. magent does not interview the patient. - `wonderful_to_be_alive` (boolean, required): Do you think it is wonderful to be alive now? (Sheikh 1986 GDS-15 item 11). true or false as assigned by the caller. false is the depression-direction answer and scores 1. magent does not interview the patient. - `pretty_worthless` (boolean, required): Do you feel pretty worthless the way you are now? (Sheikh 1986 GDS-15 item 12). true or false as assigned by the caller. true is the depression-direction answer and scores 1. magent does not interview the patient. - `full_of_energy` (boolean, required): Do you feel full of energy? (Sheikh 1986 GDS-15 item 13). true or false as assigned by the caller. false is the depression-direction answer and scores 1. magent does not interview the patient. - `situation_hopeless` (boolean, required): Do you feel that your situation is hopeless? (Sheikh 1986 GDS-15 item 14). true or false as assigned by the caller. true is the depression-direction answer and scores 1. magent does not interview the patient. - `most_people_better_off` (boolean, required): Do you think that most people are better off than you are? (Sheikh 1986 GDS-15 item 15). true or false as assigned by the caller. true is the depression-direction answer and scores 1. magent does not interview the patient. ## Bulk (POST) POST the same path with a JSON items array. The first item is the GET unit; each additional item is $0.002. Invalid items return HTTP 400 before settlement. Method: `POST /api/calc/gds_15` Max items: 25 Price: unit_amount + extra_item_amount * (n - 1) (unit 5000 atomic, extra 2000 atomic) Status: PREVIEW - 1 to 25 items. Each item uses the same keys as the GET query parameters. - POST of 1 item costs the same as GET. Lists longer than 25: chunk into multiple POSTs. Extra items still execute; do not pad dummy rows. - The first invalid item fails the whole request (index in the 400 JSON). You are not charged. - HTTP 200 is {count, path, items}. Each items[i] is the GET 200 body for that row. - Catalog misses (empty matches, found=false) stay paid 200s inside that slot. - x402 resource URL is this path plus n and body_sha256. Browsers that prefer text/html get the same paywall as GET; Pay retries POST with the same items. Example request: ```json { "items": [ { "afraid_something_bad": "false", "dropped_activities": "false", "full_of_energy": "true", "good_spirits": "true", "happy_most_of_time": "true", "life_empty": "false", "more_memory_problems": "false", "most_people_better_off": "false", "often_bored": "false", "often_helpless": "false", "prefer_stay_home": "false", "pretty_worthless": "false", "satisfied_with_life": "true", "situation_hopeless": "false", "wonderful_to_be_alive": "true" }, { "afraid_something_bad": "false", "dropped_activities": "false", "full_of_energy": "true", "good_spirits": "true", "happy_most_of_time": "true", "life_empty": "false", "more_memory_problems": "false", "most_people_better_off": "false", "often_bored": "false", "often_helpless": "false", "prefer_stay_home": "false", "pretty_worthless": "false", "satisfied_with_life": "true", "situation_hopeless": "false", "wonderful_to_be_alive": "true" } ] } ``` Human paywall (two-item fixture): https://api.magentlab.com/paywall/bulk/gds-15 Example 200: ```json { "count": 2, "path": "/api/calc/gds_15", "items": [ { "components": [ { "factor": "satisfied_with_life", "points": 0, "present": false }, { "factor": "dropped_activities", "points": 0, "present": false }, { "factor": "life_empty", "points": 0, "present": false }, { "factor": "often_bored", "points": 0, "present": false }, { "factor": "good_spirits", "points": 0, "present": false }, { "factor": "afraid_something_bad", "points": 0, "present": false }, { "factor": "happy_most_of_time", "points": 0, "present": false }, { "factor": "often_helpless", "points": 0, "present": false }, { "factor": "prefer_stay_home", "points": 0, "present": false }, { "factor": "more_memory_problems", "points": 0, "present": false }, { "factor": "wonderful_to_be_alive", "points": 0, "present": false }, { "factor": "pretty_worthless", "points": 0, "present": false }, { "factor": "full_of_energy", "points": 0, "present": false }, { "factor": "situation_hopeless", "points": 0, "present": false }, { "factor": "most_people_better_off", "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.", "citation": { "authors": "Sheikh JI, Yesavage JA", "doi": "10.1300/J018v05n01_09", "id": "sheikh-1986", "source": "Clin Gerontol. 1986;5(1-2):165-173", "title": "Geriatric Depression Scale (GDS): recent evidence and development of a shorter version" }, "formula": "gds_15", "formula_expression": "GDS-15 = (1 if not satisfied_with_life) + dropped_activities + life_empty + often_bored + (1 if not good_spirits) + afraid_something_bad + (1 if not happy_most_of_time) + often_helpless + prefer_stay_home + more_memory_problems + (1 if not wonderful_to_be_alive) + pretty_worthless + (1 if not full_of_energy) + situation_hopeless + most_people_better_off; Sheikh 1986 15-item short form; each yes/no as asked; reverse-scored items 1, 5, 7, 11, 13; max 15; no total-score severity bands", "max_score": 15, "score": 0 }, { "components": [ { "factor": "satisfied_with_life", "points": 0, "present": false }, { "factor": "dropped_activities", "points": 0, "present": false }, { "factor": "life_empty", "points": 0, "present": false }, { "factor": "often_bored", "points": 0, "present": false }, { "factor": "good_spirits", "points": 0, "present": false }, { "factor": "afraid_something_bad", "points": 0, "present": false }, { "factor": "happy_most_of_time", "points": 0, "present": false }, { "factor": "often_helpless", "points": 0, "present": false }, { "factor": "prefer_stay_home", "points": 0, "present": false }, { "factor": "more_memory_problems", "points": 0, "present": false }, { "factor": "wonderful_to_be_alive", "points": 0, "present": false }, { "factor": "pretty_worthless", "points": 0, "present": false }, { "factor": "full_of_energy", "points": 0, "present": false }, { "factor": "situation_hopeless", "points": 0, "present": false }, { "factor": "most_people_better_off", "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.", "citation": { "authors": "Sheikh JI, Yesavage JA", "doi": "10.1300/J018v05n01_09", "id": "sheikh-1986", "source": "Clin Gerontol. 1986;5(1-2):165-173", "title": "Geriatric Depression Scale (GDS): recent evidence and development of a shorter version" }, "formula": "gds_15", "formula_expression": "GDS-15 = (1 if not satisfied_with_life) + dropped_activities + life_empty + often_bored + (1 if not good_spirits) + afraid_something_bad + (1 if not happy_most_of_time) + often_helpless + prefer_stay_home + more_memory_problems + (1 if not wonderful_to_be_alive) + pretty_worthless + (1 if not full_of_energy) + situation_hopeless + most_people_better_off; Sheikh 1986 15-item short form; each yes/no as asked; reverse-scored items 1, 5, 7, 11, 13; max 15; no total-score severity bands", "max_score": 15, "score": 0 } ] } ``` ## Response fields - `formula` (string): gds_15 - `formula_expression` (string): Exact expression used - `score` (integer): Sheikh 1986 GDS-15 sum of fifteen yes/no items after reverse scoring (total 0-15) - `max_score` (integer): Always 15 - `components` (array): Per-item points. present is true when the answer is in the Sheikh 1986 depression direction. - `citation` (object): Sheikh and Yesavage Clin Gerontol 1986 citation - `disclaimer` (string): Not-a-device notice ## Example JSON Frozen fixture. Not a live lookup. ```json { "components": [ { "factor": "satisfied_with_life", "points": 0, "present": false }, { "factor": "dropped_activities", "points": 0, "present": false }, { "factor": "life_empty", "points": 0, "present": false }, { "factor": "often_bored", "points": 0, "present": false }, { "factor": "good_spirits", "points": 0, "present": false }, { "factor": "afraid_something_bad", "points": 0, "present": false }, { "factor": "happy_most_of_time", "points": 0, "present": false }, { "factor": "often_helpless", "points": 0, "present": false }, { "factor": "prefer_stay_home", "points": 0, "present": false }, { "factor": "more_memory_problems", "points": 0, "present": false }, { "factor": "wonderful_to_be_alive", "points": 0, "present": false }, { "factor": "pretty_worthless", "points": 0, "present": false }, { "factor": "full_of_energy", "points": 0, "present": false }, { "factor": "situation_hopeless", "points": 0, "present": false }, { "factor": "most_people_better_off", "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.", "citation": { "authors": "Sheikh JI, Yesavage JA", "doi": "10.1300/J018v05n01_09", "id": "sheikh-1986", "source": "Clin Gerontol. 1986;5(1-2):165-173", "title": "Geriatric Depression Scale (GDS): recent evidence and development of a shorter version" }, "formula": "gds_15", "formula_expression": "GDS-15 = (1 if not satisfied_with_life) + dropped_activities + life_empty + often_bored + (1 if not good_spirits) + afraid_something_bad + (1 if not happy_most_of_time) + often_helpless + prefer_stay_home + more_memory_problems + (1 if not wonderful_to_be_alive) + pretty_worthless + (1 if not full_of_energy) + situation_hopeless + most_people_better_off; Sheikh 1986 15-item short form; each yes/no as asked; reverse-scored items 1, 5, 7, 11, 13; max 15; no total-score severity bands", "max_score": 15, "score": 0 } ``` ## Errors - HTTP 400 `invalid_gds`: GDS-15 needs the fifteen Sheikh 1986 yes/no items as true or false. Returned before settlement; you are not charged. - HTTP 400 `invalid_flag`: boolean clinical flags must be true or false Returned before settlement; you are not charged. - HTTP 400 `invalid_items`: POST body must be a JSON object with only an items array Returned before settlement; you are not charged. - HTTP 400 `invalid_item_count`: items must be an array of 1 to 25 objects Returned before settlement; you are not charged. - HTTP 400 `invalid_item`: each items entry must be a JSON object Returned before settlement; you are not charged. Shared HTTP 402 and 503: https://magentlab.com/docs/payments ## Related tools - [PHQ-9](https://magentlab.com/docs/phq-9) — Sum nine caller-assigned Kroenke 2001 PHQ-9 integers (0-3) and return the published total (max 27), severity cutpoints, and ≥10 screen. - [MADRS](https://magentlab.com/docs/madrs) — Sum ten caller-assigned Montgomery 1979 MADRS items (each integer 0-6) and return the published 0-60 total. Does not apply later total-score severity bands. - [HAM-D](https://magentlab.com/docs/hamilton-depression) — Sum seventeen caller-assigned Hamilton 1960 items (eight integers 0-4 and nine integers 0-2) and return the published 0-50 total. Does not apply later total-score severity bands or the four excluded 21-item variables. ## Payment Unpaid requests return HTTP 402 even if query parameters or POST items are missing or invalid, so CDP and agents can index the path. After a PAYMENT-SIGNATURE, invalid params return HTTP 400 JSON before settlement. magent does not charge. Fix the params, then request a new 402 quote for that complete URL. Catalog misses (empty matches, found=false) are valid paid 200s. - GET the tool with Accept: application/json (do not send Accept: text/html unless you want the human paywall). - HTTP 402 means you have not paid. Decode the base64 PAYMENT-REQUIRED header. HTTP 503 is not a new quote. - Sign accepts[0] (exact, EIP-3009) with validBefore = now + maxTimeoutSeconds (600 seconds), or accepts[1] (batch-settlement deposit/voucher) on product GET. Ping and POST {items} stay exact. Magent retries transient facilitator 429/5xx before answering. - Retry the same URL with PAYMENT-SIGNATURE (base64 JSON of accepted and payload). Magent attaches canonical extensions.bazaar on CDP verify/settle; echoing 402 bazaar is optional. - Success is HTTP 200 JSON plus PAYMENT-RESPONSE. exact settles before the tool. batch-settlement verifies (and deposit-settles) before the tool and commits the charge after HTTP 2xx. HTTP 503: retry the same PAYMENT-SIGNATURE. Mint a new exact nonce only after a new HTTP 402. - offered `exact` on eip155:8453: Fixed-price USDC on Base. The buyer authorizes the advertised amount (EIP-3009). magent settles before the tool runs (paymentFlow upfront). extra.assetTransferMethod=eip3009 extra.paymentFlow=upfront. - offered `batch-settlement` on eip155:8453: Payment-channel vouchers claimed later in batches. Exact stays accepts[0]. Same-path POST {items} is still exact. extra.assetTransferMethod=eip3009 extra.paymentFlow=authorization. - not offered `upto`: Not offered. Usage-based: buyer authorizes a ceiling, seller settles the actual amount after work. Reserved for a future metered tool. Not for current calculators or code search. Same-path POST {items} is still scheme exact: one EIP-3009 authorization for GET unit plus $0.002 per extra item. That is not x402 batch-settlement (payment channels / vouchers). Shared HTTP 402 and 503 table: https://magentlab.com/docs/payments Stdio MCP (one process per host): https://magentlab.com/docs/mcp ## Guarantees - HTTP 402 is unpaid, including a missing query. After PAYMENT-SIGNATURE, invalid parameters return HTTP 400 before settlement. You are not charged. HTTP 402 never includes the tool JSON. - exact: settlement finishes before the tool (paymentFlow upfront). batch-settlement: verify/deposit before the tool; chargedCumulativeAmount commits after HTTP 2xx. Uncertain or failed settlement fails closed (HTTP 503). Retry the same PAYMENT-SIGNATURE. - HTTP 402 is unpaid only. Do not sign a second authorization because of a 503. - Execution is timeout-bounded and concurrency-capped. - Calculator inputs are stored encrypted for allowlisted operators (Magent Console). They are not in public logs, SSH lookups, catalog, or rollups. Request logs store path without query.