Finding Availability - Emma EMR Sandbox API

GET /Schedule

Returns the bookable schedule for a given provider. Query parameter actor (required): Practitioner/{providerName}. Missing returns 400.

Response

200 OK:

{
  "resourceType": "Schedule",
  "id": "Dr. Patel",
  "actor": [{ "reference": "Practitioner/Dr. Patel" }]
}

Example request

curl -G "https://your-emma-domain/api/Schedule" \
  -H "Authorization: Bearer <jwt>" \
  --data-urlencode "actor=Practitioner/Dr. Patel"

GET /Slot

Returns open 30-minute slots for a schedule. Query parameter schedule (required): Schedule/{providerName}. Query parameter start (optional): ge{date}. The ge prefix mirrors Epic’s own “greater-or-equal” date search convention. An invalid date returns 400.

Response

200 OK, a FHIR Bundle of Slot resources:

{
  "resourceType": "Bundle",
  "type": "searchset",
  "entry": [
    {
      "resource": {
        "resourceType": "Slot",
        "id": "slot-001",
        "schedule": { "reference": "Schedule/Dr. Patel" },
        "status": "free",
        "start": "2026-09-15T14:30:00.000Z",
        "end": "2026-09-15T15:00:00.000Z"
      }
    }
  ]
}

Example request

curl -G "https://your-emma-domain/api/Slot" \
  -H "Authorization: Bearer <jwt>" \
  --data-urlencode "schedule=Schedule/Dr. Patel" \
  --data-urlencode "start=ge2026-09-15"