# Mayo Clinic API

> Mayo Clinic returns condition, symptom, cause, diagnosis and treatment information, available as a workflow and API.

Mayo Clinic’s Get condition returns condition overviews from a disease or condition name, including symptoms, causes and risks when available. Get diagnosis and treatment returns diagnosis, care options and appointment preparation for a condition with a matching page.

- Page: https://fous.com/workflows/mayo-clinic
- Handle: `@mayo-clinic`
- Category: [Health](https://fous.com/workflows/category/health)
- Source website: https://mayoclinic.org
- Last verified: Sep 28, 2026
- Fous is not affiliated with Mayo Clinic.

## Methods

### Get condition

Operation `get_condition`, version 1. 1 credit per call.

Get a Mayo Clinic disease or condition overview, including symptoms, causes, when to see a doctor, risk factors, complications and prevention when available. Only public condition pages are included.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `condition` | string | yes | `"shingles"` | Disease or condition name in plain words, such as shingles or high blood pressure. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "condition"
  ],
  "properties": {
    "condition": {
      "type": "string",
      "description": "Disease or condition name in plain words, such as shingles or high blood pressure.",
      "examples": [
        "shingles",
        "high blood pressure",
        "appendicitis"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "condition": "shingles"
    },
    {
      "condition": "high blood pressure"
    },
    {
      "condition": "appendicitis"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `causes` | string or null | `"A blockage in the lining of the appendix, called the lumen, is the likely cause of appendicitis. This blockage can caus` | Causes in plain text. |
| `overview` | string or null |  | Overview of the condition in plain text. |
| `symptoms` | array |  | Symptoms in plain text. |
| `page_link` | string | `"https://www.mayoclinic.org/diseases-conditions/shingles/symptoms-causes/syc-20353054"` | Link to the Mayo Clinic condition page. |
| `prevention` | string or null |  | Prevention in plain text, or null if no prevention section exists. |
| `risk_factors` | array |  | Risk factors in plain text. |
| `complications` | string or null |  | Complications in plain text. |
| `condition_name` | string | `"Shingles"` | Name shown on the condition page. |
| `when_to_see_a_doctor` | string or null | `"Contact your health care provider as soon as possible if you suspect shingles, especially in the following situations:\` | When to see a doctor in plain text. |

**Example input**

```json
{
  "condition": "shingles"
}
```

**Example output**

```json
{
  "causes": "Shingles is caused by the varicella-zoster virus — the same virus that causes chickenpox. Anyone who's had chickenpox may develop shingles. After you recover from chickenpox, the virus enters your ner…",
  "overview": "Shingles is a viral infection that causes a painful rash. Shingles can occur anywhere on your body. It typically looks like a single stripe of blisters that wraps around the left side or the right sid…",
  "symptoms": [
    "Pain, burning or tingling",
    "Sensitivity to touch",
    "A red rash that begins a few days after the pain"
  ],
  "page_link": "https://www.mayoclinic.org/diseases-conditions/shingles/symptoms-causes/syc-20353054",
  "prevention": "A shingles vaccine may help prevent shingles. People who are eligible should get the Shingrix vaccine, which has been available in the United States since its approval by the Food and Drug Administrat…",
  "risk_factors": [
    "Age. The risk of developing shingles increases with age. Shingles typically occurs in people older than 50. And people over the age of 60 are more likely to experience more-severe complications.",
    "Some diseases. Diseases that weaken your immune system, such as HIV/AIDS and cancer, can increase your risk of shingles.",
    "Cancer treatments. Radiation or chemotherapy can lower your resistance to diseases and may trigger shingles."
  ],
  "complications": "Complications from shingles can include:\n\nPostherpetic neuralgia. For some people, shingles pain continues long after the blisters have cleared. This condition is known as postherpetic neuralgia. It o…",
  "condition_name": "Shingles",
  "when_to_see_a_doctor": "Contact your health care provider as soon as possible if you suspect shingles, especially in the following situations:\n\nThe pain and rash occur near an eye. If left untreated, this infection may lead …"
}
```

### Get diagnosis and treatment

Operation `get_diagnosis_and_treatment`, version 1. 1 credit per call.

Get diagnosis, treatment, home care, alternative medicine and appointment preparation for a Mayo Clinic condition. Only conditions with a matching diagnosis and treatment page are available.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `condition` | string | yes | `"type 2 diabetes"` | Condition name in plain words, for example type 2 diabetes. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "condition"
  ],
  "properties": {
    "condition": {
      "type": "string",
      "description": "Condition name in plain words, for example type 2 diabetes.",
      "examples": [
        "type 2 diabetes",
        "asthma",
        "migraine"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "condition": "type 2 diabetes"
    },
    {
      "condition": "asthma"
    },
    {
      "condition": "migraine"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `diagnosis` | string or null | `"A healthcare professional examines your arm for tenderness, swelling, unusual positioning and open wounds. You're asked` | Tests and exams with explanations from the diagnosis section, or null if absent. |
| `page_link` | string | `"https://www.mayoclinic.org/diseases-conditions/broken-arm/diagnosis-treatment/drc-20353266"` | Link to Mayo Clinic diagnosis and treatment page. |
| `condition_name` | string | `"Broken arm"` | Name of the condition on Mayo Clinic. |
| `treatment_options` | string or null |  | Treatment options and explanations, or null if absent. |
| `alternative_medicine` | string or null |  | Alternative medicine, or null if absent. |
| `lifestyle_and_home_remedies` | string or null |  | Lifestyle and home remedies, or null if absent. |
| `preparing_for_your_appointment` | string or null |  | Appointment preparation, or null if absent. |

**Example input**

```json
{
  "condition": "broken arm"
}
```

**Example output**

```json
{
  "diagnosis": "A healthcare professional examines your arm for tenderness, swelling, unusual positioning and open wounds. You're asked about your symptoms and how the injury happened. To confirm the break and assess…",
  "page_link": "https://www.mayoclinic.org/diseases-conditions/broken-arm/diagnosis-treatment/drc-20353266",
  "condition_name": "Broken arm",
  "treatment_options": "Treatment for a broken arm depends on the type of fracture. Healing time varies based on factors such as the severity of the break, age, overall health and nutrition. Smoking and alcohol use may slow …",
  "alternative_medicine": null,
  "lifestyle_and_home_remedies": null,
  "preparing_for_your_appointment": "Depending on the severity of the break, your healthcare professional or your care team in the emergency room may refer you or your child to an orthopedic surgeon. An orthopedic surgeon is a doctor who…"
}
```

## Quick start

Call the API with a Fous API key (`FOUS_API_KEY`). To create one, turn on Developer mode in Fous Studio, then open Keys & connections → API keys (https://app.fous.com/keys).

```bash
# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
: "${FOUS_API_KEY:?Set FOUS_API_KEY before running this example}"

curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 120 \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "api": "@mayo-clinic",
  "visibility": "public",
  "operation": "get_condition",
  "version": 1,
  "input": {
    "condition": "shingles"
  },
  "response": {
    "format": "json"
  }
}'
```

```python
# Save as fous.py and run with python3 fous.py. No packages needed.
# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
import json
import os
import urllib.error
import urllib.request

api_key = os.environ.get("FOUS_API_KEY")
if not api_key:
    raise RuntimeError("Set FOUS_API_KEY before running this example")

body = json.loads("{\n  \"api\": \"@mayo-clinic\",\n  \"visibility\": \"public\",\n  \"operation\": \"get_condition\",\n  \"version\": 1,\n  \"input\": {\n    \"condition\": \"shingles\"\n  },\n  \"response\": {\n    \"format\": \"json\"\n  }\n}")
request = urllib.request.Request(
    "https://api.fous.com/v1/query",
    data=json.dumps(body).encode("utf-8"),
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    method="POST",
)
try:
    with urllib.request.urlopen(request, timeout=120) as response:
        result = json.load(response)
except urllib.error.HTTPError as error:
    raise RuntimeError(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}") from error
if result.get("success") is False:
    raise RuntimeError(result.get("error", {}).get("message", "Request failed"))
print(json.dumps(result["data"]["output"], indent=2))
```

```typescript
// Save as fous.mts and run with npx tsx fous.mts.
// First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
const apiKey = process.env.FOUS_API_KEY;
if (!apiKey) throw new Error("Set FOUS_API_KEY before running this example");

const response = await fetch("https://api.fous.com/v1/query", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  signal: AbortSignal.timeout(120_000),
  body: JSON.stringify({
  "api": "@mayo-clinic",
  "visibility": "public",
  "operation": "get_condition",
  "version": 1,
  "input": {
    "condition": "shingles"
  },
  "response": {
    "format": "json"
  }
}),
});
type ApiResult = { success: boolean; data?: { output: unknown }; error?: { message: string } };
const result: ApiResult = await response.json();
if (!response.ok || result.success === false) {
  throw new Error(result.error?.message ?? `HTTP ${response.status}`);
}
if (!result.data) throw new Error("Missing API response data");
console.log(result.data.output);
```

Or describe the data in plain language: send `{"api":"@mayo-clinic","prompt":"Describe the data you need, with every detail"}` to the same URL. Fous fills in the input, runs the method that fits and returns only the fields you asked for; `data.route.calls[].request` is the exact call it made. Routing is free; the run costs the same.

## Use cases

- Review symptoms and causes for a condition
- Identify possible risk factors and complications
- Compare diagnosis and treatment information
- Prepare for a medical appointment
- Find home care and alternative medicine information

## FAQ

### Is Fous affiliated with Mayo Clinic?

No. Fous is not affiliated with Mayo Clinic. This workflow reads the public mayoclinic.org website and returns its data.

### How much does it cost?

Each run costs 1 credit. With pay-as-you-go, a credit costs 1¢; monthly plans cost less per credit.

### Do I need a Mayo Clinic account?

No. You only need a Fous account.

### How current is the data?

Fous gets the data from mayoclinic.org when you run it; repeating the same request within a day may return the saved result. Fous checks this workflow automatically; it last passed a check on Sep 28, 2026.

### What symptoms and causes are listed for a condition?

Get condition returns symptoms, causes and other condition overview details.

### What diagnosis and treatment information is available?

Get diagnosis and treatment returns diagnosis details and treatment options when available.

### How can I prepare for an appointment?

Get diagnosis and treatment returns appointment preparation information when available.

## Related

- [WebMD API](https://fous.com/workflows/webmd.md): Plain-language health condition and symptom guides from WebMD.
- [NHS API](https://fous.com/workflows/nhs.md): NHS provides condition and medicine guidance, with condition dates reflecting the latest pages used, and nearby England service listings ordered by distance; availability details may be missing.
- [MedlinePlus API](https://fous.com/workflows/medlineplus.md): MedlinePlus provides health information from the U.S. National Library of Medicine, including condition and symptom overviews and explanations of tests with matching pages.
- [NLM Clinical Tables API](https://fous.com/workflows/nlm-clinical-tables.md): NLM Clinical Tables provides public clinical terminology tables, with diagnosis searches that may miss relevant codes and code explanations checked against current NLM and official classification sources.
- [CDC API](https://fous.com/workflows/cdc.md): CDC provides disease facts, age-based vaccine guidance, current travel notices, and destination-specific travel health recommendations; review dates appear only when CDC supplies them.
- [ClinicalTrials.gov API](https://fous.com/workflows/clinicaltrials-gov.md): ClinicalTrials.gov helps users find studies and view public trial records, including sponsor-run or funded studies; site distances are approximate, and contacts, eligibility, or exact dates may be missing.
- [Drugs.com API](https://fous.com/workflows/drugs-com.md): Drugs.com provides public medicine guides, interaction and food or lifestyle warnings for 2–10 medicines, pill matches by imprint, color, or shape, and listed US cash prices by strength, form, and quantity.
- [World Health Organization API](https://fous.com/workflows/world-health-organization.md): The World Health Organization provides public health information, latest outbreak reports, country health statistics with up to 10 years of history when available, and topic fact sheets.
- [All Health workflows](https://fous.com/workflows/category/health)