# CIWA-Ar Score Calculator (Sullivan 1989)

> CIWA-Ar Score Calculator (Sullivan 1989) 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).

Sums the ten CIWA-Ar item scores to produce a total alcohol withdrawal severity score (max 67)

## Facts

- Endpoint: GET https://api.magentlab.com/api/calc/ciwa_ar
- 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/ciwa-ar-score-calculator-sullivan-1989-dc09acf5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__VIxT7HbbimGw30ra4dEE

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 ciwa-ar-score-calculator-sullivan-1989-dc09acf5
```

Example prompt: Calculate the CIWA-Ar total for a patient scored as: nausea/vomiting 3, tremor 4, paroxysmal sweats 2, anxiety 3, agitation 2, tactile disturbances 1, auditory disturbances 2, visual disturbances 1, headache 2, and orientation 2.

## When to prefer this

Use this endpoint when you need a fast, reliable arithmetic summation of pre-scored CIWA-Ar item values and want to avoid manual addition errors in clinical documentation or automated detox monitoring workflows. It is not a substitute for clinical observation or protocol decision-making, but is ideal for agents that have already collected clinician-assigned item scores and need the validated total.

## Known failure modes

- Missing any of the ten required query parameters returns an error
- Orientation value outside 0-4 or any other item outside 0-7 may cause validation failure or incorrect result
- Non-integer values for any parameter will be rejected
- Network or payment (x402) failures may prevent the call from completing

## How this service works

Sullivan 1989 CIWA-Ar (revised Clinical Institute Withdrawal Assessment for Alcohol). Ten caller-assigned integers: nausea/vomiting, tremor, paroxysmal sweats, anxiety, agitation, tactile, auditory, visual, and headache each 0-7; orientation 0-4 (not 0-7). Max 67. magent sums only and does not observe the patient or apply later protocol treatment cutoffs such as benzodiazepine orders. Not a diagnosis and not a medical device.

## Output

A single integer representing the summed CIWA-Ar total (0–67), calculated from the ten caller-supplied item scores. No clinical interpretation, diagnosis, treatment threshold application, or observation is included — the endpoint is strictly an arithmetic summation tool.

## 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": [
      "nausea_vomiting",
      "tremor",
      "paroxysmal_sweats",
      "anxiety",
      "agitation",
      "tactile",
      "auditory",
      "visual",
      "headache",
      "orientation"
     ],
     "properties": {
      "tremor": {
       "type": "integer",
       "description": "Caller-assigned Sullivan 1989 tremor points (integer 0-7). magent does not observe the patient."
      },
      "visual": {
       "type": "integer",
       "description": "Caller-assigned Sullivan 1989 visual disturbances points (integer 0-7). magent does not observe the patient."
      },
      "anxiety": {
       "type": "integer",
       "description": "Caller-assigned Sullivan 1989 anxiety points (integer 0-7). magent does not observe the patient."
      },
      "tactile": {
       "type": "integer",
       "description": "Caller-assigned Sullivan 1989 tactile disturbances points (integer 0-7). magent does not observe the patient."
      },
      "auditory": {
       "type": "integer",
       "description": "Caller-assigned Sullivan 1989 auditory disturbances points (integer 0-7). magent does not observe the patient."
      },
      "headache": {
       "type": "integer",
       "description": "Caller-assigned Sullivan 1989 headache / fullness in head points (integer 0-7). magent does not observe the patient."
      },
      "agitation": {
       "type": "integer",
       "description": "Caller-assigned Sullivan 1989 agitation points (integer 0-7). magent does not observe the patient."
      },
      "orientation": {
       "type": "integer",
       "description": "Caller-assigned Sullivan 1989 orientation and clouding of sensorium (integer 0-4). This item is not 0-7. magent does not observe the patient."
      },
      "nausea_vomiting": {
       "type": "integer",
       "description": "Caller-assigned Sullivan 1989 nausea and vomiting points (integer 0-7). magent does not observe the patient."
      }
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "path": "/api/calc/ciwa_ar",
  "count": 2,
  "items": [
   {
    "score": 0,
    "formula": "ciwa_ar",
    "citation": {
     "id": "sullivan-1989",
     "doi": "10.1111/j.1360-0443.1989.tb00737.x",
     "pmid": "2597811",
     "title": "Assessment of alcohol withdrawal: the revised clinical institute withdrawal assessment for alcohol scale (CIWA-Ar)",
     "source": "Br J Addict. 1989;84(11):1353-1357",
     "authors": "Sullivan JT, Sykora K, Schneiderman J, Naranjo CA, Sellers EM"
    },
    "max_score": 67,
    "components": [
     {
      "value": 0,
      "factor": "nausea_vomiting",
      "points": 0,
      "present": true
     },
     {
      "value": 0,
      "factor": "tremor",
      "points": 0,
      "present": true
     },
     {
      "value": 0,
      "factor": "paroxysmal_sweats",
      "points": 0,
      "present": true
     },
     {
      "value": 0,
      "factor": "anxiety",
      "points": 0,
      "present": true
     },
     {
      "value": 0,
      "factor": "agitation",
      "points": 0,
      "present": true
     },
     {
      "value": 0,
      "factor": "tactile",
      "points": 0,
      "present": true
     },
     {
      "value": 0,
      "factor": "auditory",
      "points": 0,
      "present": true
     },
     {
      "value": 0,
      "factor": "visual",
      "points": 0,
      "present": true
     },
     {
      "value": 0,
      "factor": "headache",
      "points": 0,
      "present": true
     },
     {
      "value": 0,
      "factor": "orientation",
      "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.",
    "formula_expression": "CIWA-Ar = nausea_vomiting + tremor + paroxysmal_sweats + anxiety + agitation + tactile + auditory + visual + headache + orientation; nine items 0-7, orientation 0-4; max 67"
   },
   {
    "score": 0,
    "formula": "ciwa_ar",
    "citation": {
     "id": "sullivan-1989",
     "doi": "10.1111/j.1360-0443.1989.tb00737.x",
     "pmid": "2597811",
     "title": "Assessment of alcohol withdrawal: the revised clinical institute withdrawal assessment for alcohol scale (CIWA-Ar)",
     "source": "Br J Addict. 1989;84(11):1353-1357",
     "authors": "Sullivan JT, Sykora K, Schneiderman J, Naranjo CA, Sellers EM"
    },
    "max_score": 67,
    "components"
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ciwa-ar-score-calculator-sullivan-1989-dc09acf5/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)