Service Root URL

URLs for the FHIR server vary by the tenant (datasource or client) being accessed, as well as other factors.

If the application is a SMART application, the service root url is provided at launch time. For standalone applications, the URL can be requested (or configured) when the application is set up to run against a specific tenant. FHIR calls will be made against URLs of the following format:

:serviceRootURL/:resource[?:parameters]

Secure Sandbox

The secure sandbox instance can be used for testing an application with authorization. The service root URL for this instance is different if the patient or a patient's proxy is logging in.

Patient or Patient's Proxy Access:

https://fhir-myrecord-sc.cerner.com/r4/2f8f5ec1-b7b8-4be5-ae27-e308284dd9c1/:resource[?:parameters]

Non-Patient:

https://fhir-ehr-sc.cerner.com/r4/2f8f5ec1-b7b8-4be5-ae27-e308284dd9c1/:resource[?:parameters]

Open Sandbox

Oracle Cerner does not currently provide an open sandbox instance of Soarian Clinicals. Please use the Secure Sandbox URL.

Resource

:resource represents the FHIR standard resource to access. Example: Patient

Parameters

Many API methods take optional parameters. For GET requests, any parameters not specified as a segment in the path can be passed as an HTTP query string parameter:

$ curl -i -H "Accept: application/json+fhir" "https://fhir-myrecord-sc.cerner.com/r4/2f8f5ec1-b7b8-4be5-ae27-e308284dd9c1/MedicationRequest?patient=4C05F5F357EE44FC874C0CF4AB249F99&status=active"

In this example, MedicationOrder is the FHIR standard resource being accessed, while patient and status are passed in the query string.

Resource Identity

Please note that no ids or identifiers in the Millennium EHR are intended to be used outside of the context of their complete URL. A complete URL is comprised of the service root url, the resource, and the parameters (if any).

For example, one must take into account the entire url and not simply the id or resource + id:

https://fhir-myrecord-sc.cerner.com/r4/2f8f5ec1-b7b8-4be5-ae27-e308284dd9c1/Patient/4C05F5F357EE44FC874C0CF4AB249F99

In another context the ID Patient/4C05F5F357EE44FC874C0CF4AB249F99 may identify another person entirely. In the following example a different resource may be returned because the context (service root url) has changed.

https://fhir-myrecord-sc.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Patient/4C05F5F357EE44FC874C0CF4AB249F99

Similarly when considering an identifier one must consider it only in its full context. Even though some identifiers may exist across multiple systems (ex: MRN) it is not guaranteed that they will refer to the same resource.

https://fhir-myrecord-sc.cerner.com/r4/2f8f5ec1-b7b8-4be5-ae27-e308284dd9c1/Patient?identifier=urn:oid:1.1.1.1.1.1|1001006

For example, when using the above MRN in a different system, we are not guaranteed that the same Patient resource is returned in the response bundle:

https://fhir-myrecord-sc.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Patient?identifier=urn:oid:1.1.1.1.1.1|1001006