A little more about the sandbox
To help you test your applications, Epic provides both an online testing harness, for playing sample calls,
and a full-fledged instance of Epic, configured according to our recommendations, that you can POST and GET data from.
Getting started with SMART on FHIR? Check out the Epic FHIR and OAuth tutorials.
If you'd like to get a dedicated OAuth2 client id for testing patient facing apps using the common clinical data set of FHIR resources in the sandbox, set up a new application using MyApps. Additional APIs and FHIR resources are available through the App Orchard program.
How do I access the sandbox?
- FHIR-based resource test GUI: Clicking "Explore the spec" on any FHIR integration points listed on open.epic.com takes you to a GUI web-based test harness that allows you to paste in commands and see the output from the server. The page also includes details about valid arguments and a list of sample data.
FHIR resource server: We also expose the server behind the web test harness (
https://open-ic.epic.com), so you can test accessing the resources from a terminal or your own FHIR-based application. Different services are hosted on different virtual directories. To get more information about how to call a particular service, navigate to the FHIR resource page that describes the service and look at the endpoints documented there.
Web-based patient portal: To allow you to test patient-facing applications, such as those enabled by the Meaningful Use API offerings, we have a
lightweight version of our patient portal, MyChart. Following the SMART on FHIR specification, use the metadata endpoint (
https://open-ic.epic.com/Argonaut/api/FHIR/Argonaut/metadata) to find endpoints for authorization and token requests. You can also log into our sandbox MyChart at
https://open-ic.epic.com/mychart/to test revocation flows. Since patients are shared in the sandbox, please do not unlink other developers’ applications. To get more information about patient-directed authorization as well as sample accounts, check out our OAuth tutorial.
- Web application launchpad: This set of APIs allows a user to authenticate to your web app with an existing Epic user session. you can currently launch your app using a simple encrypted HTTP Get query string and either unprotected SMART-on-FHIR for testing or SMART on FHIR with OAuth2.
- HL7v2 validator: Clicking "Explore the spec" on any HL7v2 integration points listed on open.epic.com takes you to a GUI web-based message format validator. The validator allows you to paste messages to validate they match Epic's recommended structure. You can access the validator here: HL7v2 Validator
How do I connect my App to Epic's APIs?
Can I have access to Epic to see if my testing worked?
If you are writing a web-based application that you intend to embed in Epic, you may find that your application may require minor modifications to embed within the Epic App Container web viewer. We offer a simple testing harness to help you validate that your web application is compatible with the embeddable web application viewer.