> ## Documentation Index
> Fetch the complete documentation index at: https://docs.carewithemma.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Test Emma's FHIR R4 EMR interface against a sandbox before connecting a live EHR

Emma implements the same FHIR R4 resources and operations an EHR integration relies on in production. Use this reference to validate that integration end-to-end, ahead of a live health-system connection: match patients, check provider availability, book and manage appointments, and write clinical documentation back to the chart.

This is Emma's own reference EMR, shaped like Epic's FHIR R4 API. It is not a connection to Epic.

This covers:

* Patient matching, Schedule and Slot availability search, Appointment booking and lifecycle, and clinical DocumentReference write-back.
* A configuration endpoint to enable this environment for your clinic.
* The live-call tools Emma's voice agent uses mid-conversation for registration, intake, booking, and abandonment follow-up — useful to exercise directly against the same sandbox data.

<Note>
  All endpoints require an authenticated Emma dashboard session. There is no separate API key or OAuth flow, see [Authentication](/api-reference/authentication). The Live-Call Tools pages use a separate x-vapi-secret header instead — see each of those pages for details.
</Note>

## Base URL

```text theme={null}
https://your-emma-domain/api
```

Your Emma contact will provide your instance's real domain.

## Who this is for

Clinic and tenant technical teams validating EHR interoperability ahead of a production connection.

## Reference

<CardGroup cols={3}>
  <Card title="Authentication" icon="key" href="/api-reference/authentication">
    Bearer JWT authentication using your Emma dashboard session.
  </Card>

  <Card title="Patient Matching" icon="user" href="/api-reference/resources/patient">
    POST /Patient/\$match
  </Card>

  <Card title="Finding Availability" icon="calendar-days" href="/api-reference/resources/finding-availability">
    GET /Schedule and GET /Slot
  </Card>

  <Card title="Managing Appointments" icon="calendar" href="/api-reference/resources/appointment">
    Search, book, reschedule, and cancel appointments.
  </Card>

  <Card title="Clinical Documentation" icon="file-lines" href="/api-reference/resources/document-reference">
    POST /DocumentReference
  </Card>

  <Card title="Environment Setup" icon="toggle-on" href="/api-reference/guides/sandbox-configuration">
    Enable this environment for your clinic.
  </Card>

  <Card title="Patient Journey Tools" icon="phone" href="/api-reference/live-call-tools/patient-journey">
    The live-call tools behind new-patient registration and billing.
  </Card>

  <Card title="Patient Intake Tools" icon="clipboard-list" href="/api-reference/live-call-tools/patient-intake">
    The live-call tools behind intake validation and submission.
  </Card>

  <Card title="EMR Scheduling Tools" icon="calendar-check" href="/api-reference/live-call-tools/emr-scheduling">
    The live-call tools behind patient verification and booking.
  </Card>

  <Card title="Abandonment Recovery Tools" icon="phone-volume" href="/api-reference/live-call-tools/abandonment-recovery">
    The live-call tools behind abandoned-checkout follow-up.
  </Card>
</CardGroup>