EMR-Link Web API

The EMR-Link Web API provides access to services for integration with Electronic Health Records software and Laboratory and Imaging service providers for the purposes of processing laboratory and imaging orders and results.
The full API method specification can be found here.

Authentication

The EMR-Link API uses Basic HTTP Authentication along with an additional AuthCode header to identify the customer organization.

Required for authenticating to the EMR-Link API are:

Organization's Authorization Code: This can be found in the Settings > Organization page of EMR-Link.
Username and Password of an authorized Web API user defined in the Organization. This is not a standard EMR-Link user and can only be provisioned by EMR-Link support personnel.

On each request made to the EMR-Link API, the following HTTP headers must be provided...

Authorization: basic {encoded user credentials}
AuthCode: {authorization code}

Where...

{encoded user credentials} is the Web API username and password combined with a colon and then base64 encoded
{authorization code} is the organization's authorization code

For EMR-Link auditing purposes, the following optional header can be supplied to indicate the user name of the external user. This user name will be included in the EMR-Link audit log information created for each access to the API. (For example, an EMR using this API may pass the user name of the user logged in to the EMR application.)

ExternalUser: {external user name or ID}

Where...

{external user name or ID} is the user name or ID of the user in the external system accessing the EMR-Link API.

Request Body Media Types

The EMR-Link API methods that require contents in the body of the HTTP Request can accept the contents in either JSON or XML format.

To send the body contents as JSON, put the following Content-Type header in the request...
Content-Type: application/json

To send the body contents as XML, put the following Content-Type header in the request...
Content-Type: application/xml

Reponse Media Types

The EMR-Link API methods can return either JSON or XML in the HTTP Responses.

To receive JSON in the response, put the following Accept header in the request...
Accept: application/json

To receive XML in the response, put the following Accept header in the request...
Accept: application/xml

If no Accept header is present in the request, JSON will be returned.