# Healthcare

Part of the HebrewCore documentation. Web: https://hc.itsbaba.com/docs#solution-healthcare · Whole docs: https://hc.itsbaba.com/docs.md · Index: https://hc.itsbaba.com/llms.txt

Patient portals, care-team tools and clinical assistants that work in English and speak to patients in Hebrew. Short messages use `domain: "clinical"` on `/v1/translate`; streamed answers, record search and verification use the [Clinical API](https://hc.itsbaba.com/docs#medical).

## What to Use

| Need | Use |
| --- | --- |
| A short message or instruction | `/v1/translate` with `domain: "clinical"`, `audience` and `patient_gender`. |
| An answer your model is still writing | Streaming: [WebSocket /v1/medical/stream](https://hc.itsbaba.com/docs#medical-stream) or [Server-Sent Events](https://hc.itsbaba.com/docs#medical-sse). |
| A Hebrew question against English records | [/v1/medical/query](https://hc.itsbaba.com/docs#medical-query). |
| Checking Hebrew written elsewhere | [/v1/medical/verify](https://hc.itsbaba.com/docs#medical-verify). |
| The patient's medications and names | `protected_terms` from your record search; `redact_terms` for names. |

## Example

```http
POST /v1/translate
{
  "text": "Take Eliquis 5 mg twice a day. Do not take ibuprofen. Your next INR check is on 03/04/2026.",
  "target_lang": "he",
  "domain": "clinical",
  "audience": "patient",
  "listener_gender": "female",
  "protected_terms": ["Eliquis 5 mg"]
}

{
  "translation": {
    "text": "יש ליטול Eliquis 5 mg פעמיים ביום. אין ליטול איבופרופן. בדיקת ה־INR הבאה שלך תתקיים ב־4 במרץ 2026.",
    "dir": "rtl",
    "protection": {
      "status": "ok",
      "spans": [
        { "type": "term", "value": "Eliquis 5 mg" },
        { "type": "abbreviation", "value": "INR" },
        { "type": "date", "value": "03/04/2026", "render": "4 במרץ 2026", "ambiguous_date": true }
      ],
      …
    }
  }
}
```

## Pitfalls

- **Server only.** `/v1/medical` refuses browser requests, and needs a key with the `medical` scope. Use synthetic data in the playground.
- **US record dates.** Clinical dates default to `MDY`; set `date_order: "DMY"` for Israeli records.
- **Fallback sentences.** Show a `fallback` sentence in English and keep the English original available.