# Rome IV Functional Heartburn Calculator (Aziz 2016)

> Rome IV Functional Heartburn Calculator (Aziz 2016) 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).

Evaluates whether a patient meets the Rome IV criteria for functional heartburn based on six caller-assigned boolean flags

## Facts

- Endpoint: GET https://api.magentlab.com/api/calc/rome_iv_heartburn
- 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/rome-iv-functional-heartburn-calculator-aziz-2016-41b13cc8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vUjQ59ZgY6VQwVNME-DXR

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 rome-iv-functional-heartburn-calculator-aziz-2016-41b13cc8
```

Example prompt: Check if this patient meets Rome IV functional heartburn criteria (Aziz 2016): they have burning retrosternal discomfort, no symptom relief despite optimal antisecretory therapy, symptoms are not explained by GERD or eosinophilic esophagitis, no major esophageal motor disorder is present, criteria have been fulfilled for the last 3 months, and symptom onset was at least 6 months ago.

## When to prefer this

Use this endpoint when you have already gathered all six Rome IV functional heartburn criteria from a clinician or structured clinical record and need a reliable, rule-based computation of whether the patient meets the Aziz 2016 Rome IV definition. Prefer this over general LLM reasoning for Rome IV criteria to ensure exact algorithmic fidelity to the published standard. Do not use this to diagnose patients, prescribe therapy, interpret pH-impedance, or differentiate from globus or reflux hypersensitivity — those require separate clinical assessment.

## Known failure modes

- Missing any of the six required boolean query parameters returns a validation error
- Passing non-boolean values for flags causes a schema validation failure
- Caller misclassifying flags (e.g. not having actually ruled out GERD) leads to clinically invalid results — the API cannot verify clinical inputs
- Network or payment failure (x402 micropayment not settled) may block the request

## How this service works

Aziz 2016 Rome IV functional heartburn. rome_iv_heartburn is true iff burning retrosternal discomfort, no relief despite optimal antisecretory therapy, not explained by GERD or eosinophilic esophagitis, no major esophageal motor disorder, last-3-months criteria, and 6-month onset. Caller assigns six flags. magent does not prescribe PPI or read pH-impedance. Not a diagnosis, not globus, not reflux hypersensitivity, not Rome IV IBS.

## Output

Returns a boolean field rome_iv_heartburn indicating whether the patient satisfies all Rome IV functional heartburn criteria per Aziz 2016. True only when all six input flags are true. No diagnosis, prescription, or clinical interpretation is provided.

## 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": [
      "burning_retrosternal_discomfort",
      "no_relief_despite_optimal_antisecretory_therapy",
      "not_explained_by_gerd_or_eoe",
      "no_major_esophageal_motor_disorder",
      "fulfilled_last_3_months",
      "onset_at_least_6_months"
     ],
     "properties": {
      "fulfilled_last_3_months": {
       "type": "boolean",
       "description": "Criteria fulfilled for the last 3 months, as assigned (Aziz 2016). true or false as assigned by the caller. magent does not take a history."
      },
      "onset_at_least_6_months": {
       "type": "boolean",
       "description": "Symptom onset at least 6 months prior to diagnosis, as assigned (Aziz 2016). true or false as assigned by the caller. magent does not take a history."
      },
      "not_explained_by_gerd_or_eoe": {
       "type": "boolean",
       "description": "Symptoms not explained by GERD or eosinophilic esophagitis, as assigned (Aziz 2016). true or false as assigned by the caller. magent does not read pH-impedance."
      },
      "burning_retrosternal_discomfort": {
       "type": "boolean",
       "description": "Burning retrosternal discomfort or pain, as assigned (Aziz 2016). true or false as assigned by the caller. magent does not examine the patient."
      },
      "no_major_esophageal_motor_disorder": {
       "type": "boolean",
       "description": "Absence of a major esophageal motor disorder, as assigned (Aziz 2016). true or false as assigned by the caller. magent does not interpret manometry."
      },
      "no_relief_despite_optimal_antisecretory_therapy": {
       "type": "boolean",
       "description": "No symptom relief despite optimal antisecretory therapy, as assigned (Aziz 2016). true or false as assigned by the caller. magent does not prescribe PPI."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": 
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/rome-iv-functional-heartburn-calculator-aziz-2016-41b13cc8/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)
