{"uid":"cap_Hca8BMsJkkMBIvKPwqDZB","slug":"rome-iv-biliary-pain-classifier-cotton-2016-e2d6665b","name":"Rome IV Biliary Pain Classifier (Cotton 2016)","description":"Cotton 2016 Rome IV E1 biliary pain. rome_iv_biliary_pain is true iff epigastric or RUQ pain builds to a 30-min steady level, occurs at different intervals (not daily), interrupts activities or leads to an ED visit, and is not significantly related to bowel movements or relieved by posture or acid suppression. Supportive flags reported, not required. magent does not examine the patient or read ultrasound, HIDA, or ERCP. Not a diagnosis, not functional gallbladder, not biliary or pancreatic SOD.","url":"https://api.magentlab.com/api/calc/rome_iv_biliary_pain","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":["epigastric_or_ruq_pain","builds_to_steady_level_lasts_30_min_or_longer","occurring_at_different_intervals_not_daily","severe_enough_to_interrupt_activities_or_ed_visit","not_significantly_related_to_bowel_movements","not_significantly_relieved_by_postural_change_or_acid_suppression","nausea_and_vomiting","radiation_to_back_or_right_infra_subscapular","waking_from_sleep"],"properties":{"waking_from_sleep":{"type":"boolean","description":"Pain may wake the patient from sleep, a supportive criterion that is not required for rome_iv_biliary_pain (Cotton 2016). true or false as assigned by the caller. magent does not take a history."},"nausea_and_vomiting":{"type":"boolean","description":"Pain may be associated with nausea and vomiting, a supportive criterion that is not required for rome_iv_biliary_pain (Cotton 2016). true or false as assigned by the caller. magent does not take a history."},"epigastric_or_ruq_pain":{"type":"boolean","description":"Pain located in the epigastrium and/or right upper quadrant (Cotton 2016 Rome IV E1 biliary pain). true or false as assigned by the caller. magent does not examine the patient."},"occurring_at_different_intervals_not_daily":{"type":"boolean","description":"Pain occurring at different intervals (not daily), as assigned (Cotton 2016). true or false as assigned by the caller. magent does not take a history."},"not_significantly_related_to_bowel_movements":{"type":"boolean","description":"Pain not significantly (<20%) related to bowel movements, as assigned (Cotton 2016). true or false as assigned by the caller. magent does not take a history."},"radiation_to_back_or_right_infra_subscapular":{"type":"boolean","description":"Pain may radiate to the back and/or right infra subscapular region, a supportive criterion that is not required for rome_iv_biliary_pain (Cotton 2016). true or false as assigned by the caller. magent does not examine the patient."},"builds_to_steady_level_lasts_30_min_or_longer":{"type":"boolean","description":"Pain builds up to a steady level and lasts 30 minutes or longer, as assigned (Cotton 2016). true or false as assigned by the caller. magent does not take a history."},"severe_enough_to_interrupt_activities_or_ed_visit":{"type":"boolean","description":"Pain severe enough to interrupt daily activities or lead to an emergency department visit, as assigned (Cotton 2016). true or false as assigned by the caller. magent does not take a history."},"not_significantly_relieved_by_postural_change_or_acid_suppression":{"type":"boolean","description":"Pain not significantly (<20%) relieved by postural change or acid suppression, as assigned (Cotton 2016). true or false as assigned by the caller. magent does not take a history."}}}},"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_o0edAWKCXROKoLJSkJgl0","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":"Evaluates whether a patient's reported symptoms meet the Rome IV E1 criteria for biliary pain based on caller-assigned boolean flags","exampleAgentPrompt":"My patient has epigastric pain that builds to a steady level lasting at least 30 minutes, occurs at different intervals (not daily), is severe enough to interrupt normal activities, is not significantly related to bowel movements, and is not relieved by postural changes or acid suppression — they also have nausea and vomiting but no radiation to the back and no waking from sleep. Do they meet Rome IV biliary pain criteria?","exampleUseCases":[{"title":"Gastroenterology clinic symptom triage","prompt":"I'm seeing a patient with right upper quadrant pain that builds to a steady level over about 30 minutes, happens every few weeks but not daily, is bad enough that they went to the ER once, has no clear relation to bowel movements, and antacids don't help — they also report waking from sleep with it. Can you check if this meets the Rome IV E1 biliary pain criteria?"},{"title":"Clinical research patient phenotyping","prompt":"I need to flag patients in our dataset who meet Rome IV biliary pain criteria. For this record: epigastric pain true, builds to steady level true, not daily true, interrupts activities true, not related to bowel movements true, not relieved by posture or acid suppression true, nausea and vomiting true, radiation to back false, waking from sleep false. Does this patient meet the classification?"},{"title":"EHR-integrated decision support check","prompt":"Before referring this patient for a HIDA scan, I want to confirm their pain pattern fits Rome IV biliary pain: the pain is in the RUQ, reaches a plateau and lasts over 30 minutes, comes at irregular intervals, is not daily, is not associated with bowel movements, doesn't respond to position changes or PPIs, and there's no nausea or radiation to the back. What's the Rome IV result?"}],"resultDescription":"Returns a rome_iv_biliary_pain boolean indicating whether all required Rome IV E1 criteria are met, along with the supportive criteria flags (nausea/vomiting, radiation to back, waking from sleep) reported by the caller. This is a computational classification only — not a clinical diagnosis and not a determination of functional gallbladder disorder or biliary/pancreatic SOD.","failureModes":["Missing required boolean query parameters returns a validation error","Misassigned boolean values by the caller produce an incorrect classification — garbage in, garbage out","Endpoint does not examine the patient, take history, or read imaging; accuracy depends entirely on caller-supplied flags","Network timeout or API unavailability returns a connection error"],"whenToPreferThis":"Use this endpoint when you need a fast, reproducible, criterion-by-criterion application of the Cotton 2016 Rome IV E1 biliary pain classification based on structured symptom flags already gathered from history. It is ideal for clinical decision support pipelines, research phenotyping, or EHR-integrated triage where symptoms have already been encoded as booleans. Do not use it as a substitute for clinical examination, imaging interpretation, or diagnosis of functional gallbladder disorder or SOD.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T07:10:23.242Z","isFirstParty":false}