# magent PUQE Score Calculator (Koren 2002, 12-hour)

> magent PUQE Score Calculator (Koren 2002, 12-hour) 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-14).

Computes the Koren 2002 Pregnancy-Unique Quantification of Emesis and Nausea (PUQE) score by summing three caller-supplied 1–5 integer ratings for nausea duration, vomiting episodes, and retching episodes over the last 12 hours.

## Facts

- Endpoint: GET https://api.magentlab.com/api/calc/puqe
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/magent-puqe-score-calculator-koren-2002-12-hour-c4b87d08
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Q2xyJIjAfJn1D-mwfX4XM

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 magent-puqe-score-calculator-koren-2002-12-hour-c4b87d08
```

Example prompt: Calculate the 12-hour Koren 2002 PUQE score for a patient who had nausea lasting 2–3 hours (score 3), vomited 3–4 times (score 3), and retched 1–2 times (score 2).

## When to prefer this

Use this endpoint when you need to compute the original Koren 2002 12-hour PUQE score specifically — not the later 24-hour or trimester-long variants. Prefer it when integrating structured clinical scoring into an obstetric or research workflow where the caller has already elicited and encoded the three PUQE items as integers 1–5, and simply needs the validated sum returned reliably without building the arithmetic locally.

## Known failure modes

- Missing required parameter (nausea_duration, vomiting_episodes, or retching_episodes) results in an error response
- Integer values outside the 1–5 range may be rejected or produce out-of-range totals
- Non-integer query parameter values will fail validation
- Payment failure via x402 protocol will block the request

## How this service works

Koren 2002 12-hour PUQE: three caller-assigned integers 1-5 (nausea duration, vomiting episodes, and retching episodes over the last 12 hours as in that paper's table). Sum 3-15. magent does not interview the patient. Koren 2002 published no 3-6 / 7-12 / ≥13 total-score cuts; later 24-hour and trimester-long forms are not scored. Not an antiemetic order and not a medical device.

## Output

Returns the Koren 2002 12-hour PUQE total score as an integer from 3 (no symptoms) to 15 (maximum severity), derived by summing the three caller-supplied subscores. No severity-band labels (mild/moderate/severe) are applied, as Koren 2002 defined no such cut-points for this instrument.

## 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_duration",
      "vomiting_episodes",
      "retching_episodes"
     ],
     "properties": {
      "nausea_duration": {
       "type": "integer",
       "description": "Caller-assigned Koren 2002 PUQE nausea duration in the last 12 hours (integer 1-5): 1 not at all; 2 1 hour or less; 3 2-3 hours; 4 4-6 hours; 5 more than 6 hours. magent does not interview the patient."
      },
      "retching_episodes": {
       "type": "integer",
       "description": "Caller-assigned Koren 2002 PUQE retching or dry heaves without bringing anything up in the last 12 hours (integer 1-5): 1 no time; 2 1-2 times; 3 3-4 times; 4 5-6 times; 5 7 or more times. magent does not interview the patient."
      },
      "vomiting_episodes": {
       "type": "integer",
       "description": "Caller-assigned Koren 2002 PUQE vomiting episodes in the last 12 hours (integer 1-5): 1 did not throw up; 2 1-2 times; 3 3-4 times; 4 5-6 times; 5 7 or more times. magent does not interview the patient."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/magent-puqe-score-calculator-koren-2002-12-hour-c4b87d08/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)