Object Definition
{
"id": 67176890458, // long(64) read-only
"scheduled_date": "2016-10-13T11:15:00Z", // datetime(iso8601)
"duration": 15, // integer (in minutes)
"time_slot_type": "appointment",
"time_slot_status": null,
"reason": "Follow-Up", // string(50), not nullable
"description": "follow up to procedure", // string(500)
"status": { // optional in "Create"
"status": "Not Seen", // required in "Update"
"room": "Room 102",
"status_date": "2016-10-13T01:02:37", // read-only
"status_detail": "No Show" // only available for status "Not Seen"
},
"service_location": {
"id": 13631735,
"name": "Elation North",
"place_of_service": 1, // int(32)
"address_line1": "1234 First Practice Way",
"address_line2": "",
"city": "San Francisco",
"state": "CA",
"zip": "94114",
"phone": "555-555-5555",
},
"telehealth_details": "video platform", // string - ***Deprecated 2024-06-11
"patient": 64058687489, // long(64)
"physician": 131074, // long(64)
"practice": 65540, // long(64)
"recurring_event_schedule": null,
"billing_details": { // billing information for appointments must be enabled for practice
"billing_note": "", // string(500)
"referring_provider": "", // string(100)
"referring_provider_state": "CA" // string(2)
},
"payment": {
"id": 140755836010857, // long(64) read-only
"amount": "20.00",
"when_collected": "2020-01-27T16:17:43Z",
"bill": null,
"appointment": 67176890458,
"create_date": "2020-01-27T16:17:43Z",
"delete_date": null
},
"metadata": null,
"created_date": "2016-10-13T00:47:01Z", // datetime(iso8601) read-only
"last_modified_date": "2016-10-13T00:59:16Z", // datetime(iso8601) read-only
"deleted_date": null, // datetime(iso8601) read-only
"mode": "IN_PERSON", // IN_PERSON or VIDEO
"instructions": "Please arrive 5 minutes early" // string(500)
}
| Attribute | Allowed Values |
|---|---|
| status.status | "Scheduled", "Confirmed", "Checked Out", "Cancelled", "With Doctor", "In Room", "Checked In", "In Room - Vitals Taken", "Not Seen", "Billed" |
| status.status_detail | "No Show", "Left Without Seeing", "Other"; only available when status.status is set to "Not Seen" |
| status.room | the value must be one of available rooms |
| duration | 5-min increment and must be between 1 to 1440 |
The "reason" field should not be free-text. The values are mapped to "appointment types" in the EMR.
Reasons that aren't already represented by a structured Appointment Type in Elation will cause one to be created for the practice automatically when we receive them.
When the "mode" field is set to "VIDEO", "instructions" is not populated in the request, and the physician has custom virtual visit instructions in the EMR, the "instructions" field will populate with those custom instructions. If "instructions" is populated via the request, those custom instructions are respected.
The "telehealth_details" field is deprecated. Use the "instructions" field. "telehealth_details" will still appear in the response body, but it cannot be different from "instructions".