# Blue Banana EHR

> Synthetic FHIR R4 EHR sandbox for developers. Every patient is generated by Synthea and carries the `http://bluebananaehr.com/synthetic-data` extension — no real PHI. Start with the human-readable docs.

> The working surface is the FHIR R4 CRUD endpoints at `/api/fhir/r4/*` plus webhook subscriptions (`/api/subscriptions`) and intake forms (`/api/intake/*`). All three accept bearer-API-key auth and deliver signed webhooks end-to-end. The agent runtime remains documented for forward compatibility only.

## Docs
- [Quickstart and concepts](https://bluebananaehr.com/docs)
- [API reference (Scalar)](https://bluebananaehr.com/docs/api)
- [Webhook guide](https://bluebananaehr.com/docs/webhooks)

## Other (currently not working)
- [Streaming guide (SSE)](https://bluebananaehr.com/docs/streaming) — `POST /api/agent` rejects every published `useCase` value.

## Machine-readable
- [OpenAPI 3.1 spec](https://bluebananaehr.com/openapi.json) — tags prefixed `Experimental —` group the not-currently-working endpoints.
- [Full plain-text dump](https://bluebananaehr.com/llms-full.txt)
- [FHIR CapabilityStatement](https://bluebananaehr.com/api/fhir/r4/metadata)