# RASS Score Lookup

> RASS Score Lookup is a paid API for AI agents from api.magentlab.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Returns the published term and description for a Richmond Agitation-Sedation Scale (RASS) integer value (-5 to +4) as defined by Sessler 2002

## Facts

- Endpoint: GET https://api.magentlab.com/api/calc/rass
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/rass-score-lookup-1447f41f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_uHwvGu4mALTcnOwPSa9O3

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability rass-score-lookup-1447f41f
```

Example prompt: Look up the official Sessler 2002 RASS term and description for a score of -3 — I've already assessed the patient and just need the published label and what it means.

## When to prefer this

Use this endpoint when you already have a RASS integer assigned by a clinician and need to retrieve the canonical Sessler 2002 term and description for documentation, reporting, or display. This endpoint does NOT perform patient assessment, administer stimulation, or interact with CAM-ICU; prefer it purely for encoding a known numeric RASS score into its published text representation.

## Known failure modes

- Integer out of range (outside -5 to +4) returns an error or empty result
- Non-integer input rejected by schema validation
- Missing required 'rass' query parameter returns HTTP 400
- Network timeout or service unavailability returns HTTP 5xx

## How this service works

Richmond Agitation-Sedation Scale (RASS, Sessler 2002) as assigned by the caller: integer -5 to +4 with the published term and description (Combative through Unarousable). magent does not observe the patient, administer voice or physical stimulation, or titrate sedation. Not a CAM-ICU feature, not a CAM-ICU administration, and not a sedation order or dose.

## Output

Returns the official published RASS term (e.g. 'Moderate sedation') and its clinical description (e.g. 'Movement or eye opening to voice but no eye contact') corresponding to the supplied integer score, as defined in Sessler 2002. Does not include any patient observation, stimulation response, or treatment recommendation.

## Request schema (JSON Schema)

```json
{
 "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": [
      "rass"
     ],
     "properties": {
      "rass": {
       "type": "integer",
       "description": "Sessler 2002 RASS integer -5 to +4 as assigned by the caller (+4 Combative; +3 Very agitated; +2 Agitated; +1 Restless; 0 Alert and calm; -1 Drowsy; -2 Light sedation; -3 Moderate sedation; -4 Deep sedation; -5 Unarousable). magent does not observe the patient, administer voice or physical stimulation, or titrate sedation."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "path": "/api/calc/rass",
  "count": 2,
  "items": [
   {
    "rass": 0,
    "term": "Alert and calm",
    "score": 0,
    "formula": "rass",
    "citation": {
     "id": "sessler-2002",
     "doi": "10.1164/rccm.2107138",
     "pmid": "12421743",
     "title": "The Richmond Agitation-Sedation Scale: validity and reliability in adult intensive care unit patients",
     "source": "Am J Respir Crit Care Med. 2002;166(10):1338-1344",
     "authors": "Sessler CN, Gosnell MS, Grap MJ, et al."
    },
    "max_score": 4,
    "components": [
     {
      "factor": "rass",
      "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.",
    "description": "Alert and calm",
    "formula_expression": "RASS integer -5 to +4 as assigned by the caller; Sessler 2002 ten levels (Combative through Unarousable)"
   },
   {
    "rass": 0,
    "term": "Alert and calm",
    "score": 0,
    "formula": "rass",
    "citation": {
     "id": "sessler-2002",
     "doi": "10.1164/rccm.2107138",
     "pmid": "12421743",
     "title": "The Richmond Agitation-Sedation Scale: validity and reliability in adult intensive care unit patients",
     "source": "Am J Respir Crit Care Med. 2002;166(10):1338-1344",
     "authors": "Sessler CN, Gosnell MS, Grap MJ, et al."
    },
    "max_score": 4,
    "components": [
     {
      "factor": "rass",
      "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.",
    "description": "Alert and calm",
    "formula_expression": "RASS integer -5 to +4 as assigned by the caller; Sessler 2002 ten levels (Combative through Unarousable)"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/rass-score-lookup-1447f41f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.magentlab.com](https://www.zero.xyz/host/api.magentlab.com/llms.txt)