{"uid":"cap_Yh1juic4Qj7j7EgDXgEhN","slug":"magent-liu-2004-respiratory-clinical-score-calculator-456cd74a","name":"magent Liu 2004 Respiratory Clinical Score Calculator","description":"Liu 2004 respiratory clinical score: four caller-assigned 0-3 domains — respiratory_rate (age-banded Table 1 ordinal, not raw breaths/min), retractions, dyspnea, and auscultation. magent sums only (max 12) and does not count breaths or auscultate. Score only; Liu 2004 does not print mild/moderate/severe total-score cutoffs. Not a diagnosis or treatment order. Not PRAM. Not Westley 1978 croup.","url":"https://api.magentlab.com/api/calc/liu_respiratory","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":["respiratory_rate","retractions","dyspnea","auscultation"],"properties":{"dyspnea":{"type":"integer","description":"Caller-assigned Liu 2004 dyspnea (integer 0-3). 0-2 years: 0 normal feeding, vocalizations and activity; 1 one of difficulty feeding, decreased vocalization or agitated; 2 two of those; 3 stops feeding, no vocalization, drowsy or confused. 2-4 years: 0 normal feeding, vocalizations and activity; 1 one of decreased appetite, increased coughing after play, hyperactivity; 2 two of those; 3 stops eating or drinking, stops playing, or drowsy and confused. >4 years: 0 counts to ≥10 in one breath; 1 counts to 7-9; 2 counts to 4-6; 3 counts to ≤3. magent does not examine the patient."},"retractions":{"type":"integer","description":"Caller-assigned Liu 2004 retractions (integer 0-3): 0 none; 1 subcostal or intercostal; 2 two of subcostal, intercostal, substernal or nasal flaring (infant); 3 three of subcostal, intercostal, substernal, infraclavicular or nasal flaring/head bobbing (infant). magent does not examine the patient."},"auscultation":{"type":"integer","description":"Caller-assigned Liu 2004 auscultation (integer 0-3): 0 normal breathing, no wheezing; 1 end-expiratory wheeze only; 2 expiratory wheeze only (greater than end-expiratory); 3 inspiratory and expiratory wheeze or diminished breath sounds or both. magent does not auscultate."},"respiratory_rate":{"type":"integer","description":"Caller-assigned Liu 2004 respiratory-rate points (integer 0-3), not raw breaths/min. Table 1 age bands for 1/2/3: <2 months ≤60 / 61-69 / ≥70; 2-12 months ≤50 / 51-59 / ≥60; 1-2 years ≤40 / 41-44 / ≥45; 2-3 years ≤34 / 35-39 / ≥40; 4-5 years ≤30 / 31-35 / ≥36; 6-12 years ≤26 / 27-30 / ≥31; >12 years ≤23 / 24-27 / ≥28. 0 is the 0-point ordinal. magent does not count breaths."}}}},"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_5Ra0JfLnM-yvbp5Pns3wV","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":"Sums the four caller-assigned Liu 2004 respiratory clinical score domains (respiratory rate, retractions, dyspnea, auscultation) to produce a total score out of 12","exampleAgentPrompt":"Calculate the Liu 2004 respiratory clinical score for a child with a respiratory rate score of 2, retractions score of 1, dyspnea score of 2, and auscultation score of 1 — what is the total out of 12?","exampleUseCases":[{"title":"Pediatric ED respiratory triage scoring","prompt":"I'm documenting a pediatric patient: respiratory rate score is 3, retractions score is 2, dyspnea score is 2, and auscultation score is 2 — can you calculate the Liu 2004 respiratory clinical score total for charting?"},{"title":"Clinical decision support workflow integration","prompt":"As part of my respiratory assessment workflow, compute the Liu 2004 score for a child with respiratory rate points 1, retractions 0, dyspnea 1, and auscultation 2."},{"title":"Research data scoring for retrospective chart review","prompt":"I'm scoring historical patient charts using Liu 2004 criteria — this patient has respiratory rate 0, retractions 1, dyspnea 0, auscultation 1, what's the total score?"}],"resultDescription":"Returns the total Liu 2004 respiratory clinical score as an integer between 0 and 12, computed by summing the four caller-assigned ordinal domain scores (respiratory_rate, retractions, dyspnea, auscultation). No severity band labels are provided, as Liu 2004 does not define mild/moderate/severe cutoffs for the total score.","failureModes":["Missing any of the four required query parameters returns an error","Domain values outside the valid 0-3 integer range will be rejected","Non-integer values for any domain score will fail validation","Payment failure (402) if x402 payment header is not correctly provided"],"whenToPreferThis":"Use this endpoint when you need to arithmetically compute the Liu 2004 respiratory clinical score from four pre-assessed ordinal domain values. Prefer this over manual calculation to ensure correctness and auditability. Note this is NOT the PRAM score, NOT the Westley 1978 croup score, and does NOT interpret severity bands — it only sums the four provided scores.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:59:43.437Z","isFirstParty":false}