{"uid":"cap_TES6goU-4T28sStQJANkG","slug":"magent-stanford-sleepiness-scale-calculator-15bb4665","name":"magent Stanford Sleepiness Scale Calculator","description":"Hoddes 1973 Stanford Sleepiness Scale degree 1-7 as assigned by the caller. Returns the degree, score (same as the degree), max 7, and published wording (feeling active and vital; alert; wide awake through almost in reverie; sleep onset soon). Not the Epworth Sleepiness Scale. Not a sleep-disorder diagnosis; magent does not observe the patient.","url":"https://api.magentlab.com/api/calc/stanford_sleepiness","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":["stanford_sleepiness"],"properties":{"stanford_sleepiness":{"type":"integer","description":"Hoddes 1973 Stanford Sleepiness Scale degree 1-7 as assigned by the caller (1 feeling active and vital, alert, wide awake; 2 functioning at a high level, but not at peak, able to concentrate; 3 relaxed, awake, not at full alertness, responsive; 4 a little foggy, not at peak, let down; 5 fogginess, beginning to lose interest in remaining awake, slowed down; 6 sleepiness, prefer to be lying down, fighting sleep, woozy; 7 almost in reverie, sleep onset soon, lost struggle to remain awake). Not Epworth. magent does not observe 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_pNSOjDIKDKlZeogF5luuZ","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 Hoddes 1973 Stanford Sleepiness Scale score, published wording, and metadata for a caller-assigned degree 1–7.","exampleAgentPrompt":"Look up Stanford Sleepiness Scale degree 5 and give me the published Hoddes 1973 wording for that level.","exampleUseCases":[{"title":"Clinical documentation of sleepiness level","prompt":"The patient self-reports they're foggy and losing interest in staying awake — that sounds like a 5 on the Stanford Sleepiness Scale. Can you fetch the official Hoddes 1973 wording for degree 5 so I can include it verbatim in the chart?"},{"title":"Research data annotation with SSS labels","prompt":"I'm coding sleep study observations and I've assigned each participant a Stanford Sleepiness Scale degree. For participant 3 I assigned degree 2 — pull the official published description so I can attach it to the record."},{"title":"Alertness check before a clinical procedure","prompt":"Before starting the procedure, the nurse rated the patient at SSS level 6. What is the official Stanford Sleepiness Scale wording for degree 6 and what's the maximum possible score on that scale?"}],"resultDescription":"Returns a JSON object with the integer degree (1–7) echoed back, the numeric score (equal to the degree), the maximum possible score (7), and the verbatim published Hoddes 1973 wording for that level (e.g. 'almost in reverie; sleep onset soon; lost struggle to remain awake' for degree 7).","failureModes":["Missing or out-of-range degree (not 1–7) returns a validation error","Non-integer value for stanford_sleepiness parameter causes a 400-level error","Payment failure (x402 protocol) blocks the request before computation","No network connectivity to api.magentlab.com results in timeout"],"whenToPreferThis":"Choose this endpoint when you need the verbatim Hoddes 1973 Stanford Sleepiness Scale published wording for a caller-assigned degree 1–7, as opposed to the Epworth Sleepiness Scale or any other subjective sleepiness instrument. It does not diagnose sleep disorders and does not observe or assess the patient — the caller is responsible for assigning the degree. Prefer this over manual lookup when building clinical documentation pipelines, research annotation tools, or any workflow that needs the exact published SSS text programmatically.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T13:11:36.542Z","isFirstParty":false}