{"uid":"cap_Q2xyJIjAfJn1D-mwfX4XM","slug":"magent-puqe-score-calculator-koren-2002-12-hour-c4b87d08","name":"magent PUQE Score Calculator (Koren 2002, 12-hour)","description":"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.","url":"https://api.magentlab.com/api/calc/puqe","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":["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"}}}}},"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_n0oDzjgV7KivW2KIFeM2r","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":"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.","exampleAgentPrompt":"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).","exampleUseCases":[{"title":"Obstetric triage NVP severity scoring","prompt":"Score a pregnant patient's nausea and vomiting using the 12-hour PUQE: she had nausea for 4–6 hours (score 4), vomited 5–6 times (score 4), and had no retching (score 1) — what's her total PUQE?"},{"title":"Clinical app pregnancy symptom tracker","prompt":"My patient reported mild morning sickness today: nausea for 1 hour or less (score 2), vomited once or twice (score 2), and retched 1–2 times (score 2). Give me the Koren 2002 PUQE total for the last 12 hours."},{"title":"Research data pipeline NVP quantification","prompt":"I need to compute the Koren 2002 12-hour PUQE score for a study participant: nausea duration score 5, vomiting episodes score 5, retching episodes score 5 — what is the total?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T07:11:08.359Z","isFirstParty":false}