FHIR API Quickstart

Get your first FHIR R4 API call working in under 5 minutes. No FHIR experience required, no partner application, no onboarding call.

1. Get an API key

Sign up free, open Settings → API Keys, and create a key. Keys are bearer tokens — send them as Authorization: Bearer <key>. The Free tier is read-only and needs no credit card.

2. Search for patients

GET https://api.mock.health/fhir/Patient?_count=5 returns a FHIR Bundle of synthetic Patient resources — each one US Core 6.1 profiled, with real-looking names, identifiers, addresses, and birth dates.

3. Pull a whole chart

GET https://api.mock.health/fhir/Patient/{id}/$everything returns the complete patient compartment in one Bundle: encounters, conditions, medications, observations, diagnostic reports, imaging studies, and clinical notes. This is the call that shows the difference between a fixture and a patient — mock.health charts are generated by a Markov progression module trained on millions of real patient journeys, so conditions correlate, labs trend, and medications follow diagnoses.

4. Filter with search parameters

Every resource supports standard FHIR R4 search: Observation?patient={id}&category=vital-signs, Condition?clinical-status=active, MedicationRequest?status=active. Add _include and _revinclude to pull referenced resources in the same Bundle.

Next

Browse the API reference for per-resource search parameters, read the SMART on FHIR guide to add OAuth 2.0 app launch, or see the map to make responses come back shaped like Epic, Oracle Health (Cerner), or MEDITECH. Stuck? Troubleshooting covers the common errors.