FHIR DSTU2 - Chart - Orders & Results, Vitals
These FHIR Orders & Results, Vitals (Charts) endpoints are a partial implementation of the FHIR DSTU2 specification. We will consider expanding these and adding additional FHIR endpoints, as well as future versions, based on usage and requests from API users.
Note-1: that these endpoints do not follow the same naming conventions as many of the other APIs offered.
Note-2: If you are accessing a practice without Communicator Brands and are using one of the endpoints that require BRANDID in the path, you can use any positive integer for BRANDID.
Note-3: GET /v1/{practiceid}/{brandid}/{chartsharinggroupid}/fhir/dstu2/Observation/ResultObservation-{resultobservationid} only returns results that have been published to the Patient Portal.
Was this information helpful?
Yes | No
Thank you for your feedback!
What went wrong?
Incomplete or incorrect information |
Irrelevant Content
| Others
Submit
Endpoints
-
Primary
Gets a list of procedures for a given
patient.
GET
/v1/{practiceid}/{departmentid}/fhir/dstu2/Procedure
List of Procedure resources from the results of the search
Was this information helpful?
Yes | No
Thank you for your feedback!
What went wrong?
Incomplete or incorrect information |
Irrelevant Content
| Others
Submit
Input Parameters
Expand all❙ required
practiceid
integer
practiceid
departmentid
integer
departmentid
patient
integer
The patient ID (same as "PATIENTID" in non-FHIR calls).
date
string
Filter results within a specific time period or date. Prefix: eq - specific, le - inclusive less, lt - exclusive less, ge - inclusive greater, gt - exclusive greater, separate start and end date with space. Example: ge2015-06-1 le2015-06-22
_lastupdated
string
Last updated filter
THIRDPARTYUSERNAME
string
User name of the patient in the third party application.
PATIENTFACINGCALL
boolean
When 'true' is passed we will collect relevant data and store in our database.
Output Parameters
Expand all
code
object
Identification of the procedure
id
string
Logical id of this artifact
performeddatetime
string
Date/Period the procedure was performed
resourcetype
string
The type of resource
status
string
in-progress | aborted | completed | entered-in-error
subject
object
Who the procedure was performed on
Example Code
Get a specific procedure by
ID
GET
/v1/{practiceid}/{departmentid}/fhir/dstu2/Procedure/{procedureid}
Procedure resource from given ID
Was this information helpful?
Yes | No
Thank you for your feedback!
What went wrong?
Incomplete or incorrect information |
Irrelevant Content
| Others
Submit
Input Parameters
Expand all❙ required
practiceid
integer
practiceid
departmentid
integer
departmentid
procedureid
integer
procedureid
patient
integer
The patient ID (same as "PATIENTID" in non-FHIR calls).
Output Parameters
Expand all
code
object
Identification of the procedure
id
string
Logical id of this artifact
performeddatetime
string
Date/Period the procedure was performed
resourcetype
string
The type of resource
status
string
in-progress | aborted | completed | entered-in-error
subject
object
Who the procedure was performed on
Example Code
Gets a list of procedures for a given
patient.
GET
/v1/{practiceid}/{brandid}/{chartsharinggroupid}/fhir/dstu2/Procedure
List of Procedure resources from the results of the search
Was this information helpful?
Yes | No
Thank you for your feedback!
What went wrong?
Incomplete or incorrect information |
Irrelevant Content
| Others
Submit
Input Parameters
Expand all❙ required
practiceid
integer
practiceid
brandid
integer
brandid
chartsharinggroupid
integer
chartsharinggroupid
patient
integer
The patient ID (same as "PATIENTID" in non-FHIR calls).
date
string
Filter results within a specific time period.
THIRDPARTYUSERNAME
string
User name of the patient in the third party application.
PATIENTFACINGCALL
boolean
When 'true' is passed we will collect relevant data and store in our database.
Output Parameters
Expand all
code
object
Identification of the procedure
id
string
Logical id of this artifact
performeddatetime
string
Date/Period the procedure was performed
resourcetype
string
The type of resource
status
string
in-progress | aborted | completed | entered-in-error
subject
object
Who the procedure was performed on
Example Code
Get a specific procedure by
ID
GET
/v1/{practiceid}/{brandid}/{chartsharinggroupid}/fhir/dstu2/Procedure/{procedureid}
Procedure resource from given ID
Was this information helpful?
Yes | No
Thank you for your feedback!
What went wrong?
Incomplete or incorrect information |
Irrelevant Content
| Others
Submit
Input Parameters
Expand all❙ required
practiceid
integer
practiceid
brandid
integer
brandid
procedureid
integer
procedureid
chartsharinggroupid
integer
chartsharinggroupid
patient
integer
The patient ID (same as "PATIENTID" in non-FHIR calls).
Output Parameters
Expand all
code
object
Identification of the procedure
id
string
Logical id of this artifact
performeddatetime
string
Date/Period the procedure was performed
resourcetype
string
The type of resource
status
string
in-progress | aborted | completed | entered-in-error
subject
object
Who the procedure was performed on
Example Code
Gets a list of observations about a given
patient.
GET
/v1/{practiceid}/{departmentid}/fhir/dstu2/Observation
Returns the list of Observations. Date filtering does not apply for the social-history category.
Was this information helpful?
Yes | No
Thank you for your feedback!
What went wrong?
Incomplete or incorrect information |
Irrelevant Content
| Others
Submit
Input Parameters
Expand all❙ required
practiceid
integer
practiceid
departmentid
integer
departmentid
patient
integer
The patient ID (same as "PATIENTID" in non-FHIR calls).
date
string
Filter results within a specific time period or date. For the laboratory category, date filtering applies to the date the lab was ordered, not the date of the lab results. Prefix: eq - specific, le - inclusive less, lt - exclusive less, ge - inclusive greater, gt - exclusive greater, separate start and end date with space. Example: ge2015-06-1 le2015-06-22
category
string
Observation category code. Usable codes: social-history, laboratory and vital-signs
code
string
One or more LOINC codes (comma delimited).
THIRDPARTYUSERNAME
string
User name of the patient in the third party application.
PATIENTFACINGCALL
boolean
When 'true' is passed we will collect relevant data and store in our database.
Output Parameters
Expand all
category
object
Classification of type of observation
code
object
Type of observation (code / type)
component
array
Component results
dataabsentreason
object
Why the result is missing
effectivedatetime
string
Clinically relevant time/time-period for observation
encounter
object
Healthcare event during which this observation is made
id
string
Logical id of this artifact
issued
string
Date/Time this was made available
referencerange
array
Provides guide for interpretation
related
array
Resource related to this observation
resourcetype
string
The type of resource
status
string
registered | preliminary | final | amended | cancelled | entered-in-error | unknown
subject
object
Who and/or what this is about
valuecodeableconcept
object
Actual result
valuequantity
object
Actual result
valuestring
string
Actual result
Example Code
Gets a single result
observation
GET
/v1/{practiceid}/{departmentid}/fhir/dstu2/Observation/ResultObservation-{resultobservationid}
Observation (laboratory test and result) resource from given ID
Was this information helpful?
Yes | No
Thank you for your feedback!
What went wrong?
Incomplete or incorrect information |
Irrelevant Content
| Others
Submit
Input Parameters
Expand all❙ required
resultobservationid
integer
resultobservationid
practiceid
integer
practiceid
departmentid
integer
departmentid
patient
integer
The patient ID (same as "PATIENTID" in non-FHIR calls).
Output Parameters
Expand all
category
object
Classification of type of observation
code
object
Type of observation (code / type)
effectivedatetime
string
Clinically relevant time/time-period for observation
id
string
Logical id of this artifact
referencerange
array
Provides guide for interpretation
resourcetype
string
The type of resource
status
string
registered | preliminary | final | amended | cancelled | entered-in-error | unknown
subject
object
Who and/or what this is about
valuecodeableconcept
object
Actual result
valuestring
string
Actual result
Example Code
Get an social history observation by
ID
GET
/v1/{practiceid}/{departmentid}/fhir/dstu2/Observation/SocialHistory-{socialhistoryid}
Observation (social history) resource from given ID
Was this information helpful?
Yes | No
Thank you for your feedback!
What went wrong?
Incomplete or incorrect information |
Irrelevant Content
| Others
Submit
Input Parameters
Expand all❙ required
practiceid
integer
practiceid
socialhistoryid
integer
socialhistoryid
departmentid
integer
departmentid
patient
integer
The patient ID (same as "PATIENTID" in non-FHIR calls).
THIRDPARTYUSERNAME
string
User name of the patient in the third party application.
PATIENTFACINGCALL
boolean
When 'true' is passed we will collect relevant data and store in our database.
Output Parameters
Expand all
category
object
Classification of type of observation
code
object
Type of observation (code / type)
id
string
Logical id of this artifact
issued
string
Date/Time this was made available
resourcetype
string
The type of resource
status
string
registered | preliminary | final | amended | cancelled | entered-in-error | unknown
subject
object
Who and/or what this is about
valuecodeableconcept
object
Actual result
Example Code
Get an individual vital by
ID
GET
/v1/{practiceid}/{departmentid}/fhir/dstu2/Observation/Vital-{vitalid}
Observation (vital sign) resource from given ID
Was this information helpful?
Yes | No
Thank you for your feedback!
What went wrong?
Incomplete or incorrect information |
Irrelevant Content
| Others
Submit
Input Parameters
Expand all❙ required
practiceid
integer
practiceid
departmentid
integer
departmentid
vitalid
integer
vitalid
patient
integer
The patient ID (same as "PATIENTID" in non-FHIR calls).
Output Parameters
Expand all
category
object
Classification of type of observation
code
object
Type of observation (code / type)
dataabsentreason
object
Why the result is missing
effectivedatetime
string
Clinically relevant time/time-period for observation
encounter
object
Healthcare event during which this observation is made
id
string
Logical id of this artifact
resourcetype
string
The type of resource
status
string
registered | preliminary | final | amended | cancelled | entered-in-error | unknown
subject
object
Who and/or what this is about
valuequantity
object
Actual result
Example Code
Gets a list of observations about a given
patient.
GET
/v1/{practiceid}/{brandid}/{chartsharinggroupid}/fhir/dstu2/Observation
Returns the list of Observations. Date filtering does not apply for the social-history category.
Was this information helpful?
Yes | No
Thank you for your feedback!
What went wrong?
Incomplete or incorrect information |
Irrelevant Content
| Others
Submit
Input Parameters
Expand all❙ required
practiceid
integer
practiceid
brandid
integer
brandid
chartsharinggroupid
integer
chartsharinggroupid
patient
integer
The patient ID (same as "PATIENTID" in non-FHIR calls).
date
string
Filter results within a specific time period.
category
string
Observation category code.
code
string
One or more LOINC codes (comma delimited).
Output Parameters
Expand all
category
object
Classification of type of observation
code
object
Type of observation (code / type)
component
array
Component results
dataabsentreason
object
Why the result is missing
effectivedatetime
string
Clinically relevant time/time-period for observation
encounter
object
Healthcare event during which this observation is made
id
string
Logical id of this artifact
issued
string
Date/Time this was made available
referencerange
array
Provides guide for interpretation
related
array
Resource related to this observation
resourcetype
string
The type of resource
status
string
registered | preliminary | final | amended | cancelled | entered-in-error | unknown
subject
object
Who and/or what this is about
valuecodeableconcept
object
Actual result
valuequantity
object
Actual result
valuestring
string
Actual result
Example Code
Get an individual result observation by
ID
GET
/v1/{practiceid}/{brandid}/{chartsharinggroupid}/fhir/dstu2/Observation/ResultObservation-{resultobservationid}
Observation (laboratory test and result) resource from given ID
Was this information helpful?
Yes | No
Thank you for your feedback!
What went wrong?
Incomplete or incorrect information |
Irrelevant Content
| Others
Submit
Input Parameters
Expand all❙ required
resultobservationid
integer
resultobservationid
practiceid
integer
practiceid
brandid
integer
brandid
chartsharinggroupid
integer
chartsharinggroupid
patient
integer
The patient ID (same as "PATIENTID" in non-FHIR calls).
Output Parameters
Expand all
category
object
Classification of type of observation
code
object
Type of observation (code / type)
effectivedatetime
string
Clinically relevant time/time-period for observation
id
string
Logical id of this artifact
referencerange
array
Provides guide for interpretation
resourcetype
string
The type of resource
status
string
registered | preliminary | final | amended | cancelled | entered-in-error | unknown
subject
object
Who and/or what this is about
valuecodeableconcept
object
Actual result
valuestring
string
Actual result
Example Code
Get an individual vital by
ID
GET
/v1/{practiceid}/{brandid}/{chartsharinggroupid}/fhir/dstu2/Observation/Vital-{vitalid}
Observation (vital sign) resource from given ID
Was this information helpful?
Yes | No
Thank you for your feedback!
What went wrong?
Incomplete or incorrect information |
Irrelevant Content
| Others
Submit
Input Parameters
Expand all❙ required
practiceid
integer
practiceid
brandid
integer
brandid
vitalid
integer
vitalid
chartsharinggroupid
integer
chartsharinggroupid
patient
integer
The patient ID (same as "PATIENTID" in non-FHIR calls).
Output Parameters
Expand all
category
object
Classification of type of observation
code
object
Type of observation (code / type)
dataabsentreason
object
Why the result is missing
effectivedatetime
string
Clinically relevant time/time-period for observation
encounter
object
Healthcare event during which this observation is made
id
string
Logical id of this artifact
resourcetype
string
The type of resource
status
string
registered | preliminary | final | amended | cancelled | entered-in-error | unknown
subject
object
Who and/or what this is about
valuequantity
object
Actual result
Example Code
Find diagnostic
reports.
GET
/v1/{practiceid}/{departmentid}/fhir/dstu2/DiagnosticReport
List of DiagnosticReport resources from the results of the search
Was this information helpful?
Yes | No
Thank you for your feedback!
What went wrong?
Incomplete or incorrect information |
Irrelevant Content
| Others
Submit
Input Parameters
Expand all❙ required
practiceid
integer
practiceid
departmentid
integer
departmentid
patient
integer
The patient ID (same as "PATIENTID" in non-FHIR calls).
date
string
Filter results within a specific time period.
category
string
Observation category code.
code
string
One or more LOINC codes (comma delimited).
Output Parameters
Expand all
category
object
Service category
code
object
Name/Code for this diagnostic report
effectivedatetime
string
Clinically Relevant time/time-period for report
id
string
Logical id of this artifact
issued
string
DateTime this version was released
performer
object
Responsible Diagnostic Service
resourcetype
string
The type of resource
result
array
Observations - simple, or complex nested groups
status
string
registered | partial | final | corrected | appended | cancelled | entered-in-error
subject
object
The subject of the report, usually, but not always, the patient
Example Code
Get a single diagnostic report by lab result
ID.
GET
/v1/{practiceid}/{departmentid}/fhir/dstu2/DiagnosticReport/{labresultid}
DiagnosticReport resource from given ID
Was this information helpful?
Yes | No
Thank you for your feedback!
What went wrong?
Incomplete or incorrect information |
Irrelevant Content
| Others
Submit
Input Parameters
Expand all❙ required
practiceid
integer
practiceid
departmentid
integer
departmentid
labresultid
integer
labresultid
patient
integer
The patient ID (same as "PATIENTID" in non-FHIR calls).
Output Parameters
Expand all
category
object
Service category
code
object
Name/Code for this diagnostic report
effectivedatetime
string
Clinically Relevant time/time-period for report
id
string
Logical id of this artifact
issued
string
DateTime this version was released
performer
object
Responsible Diagnostic Service
resourcetype
string
The type of resource
result
array
Observations - simple, or complex nested groups
status
string
registered | partial | final | corrected | appended | cancelled | entered-in-error
subject
object
The subject of the report, usually, but not always, the patient
Example Code
Find diagnostic
reports.
GET
/v1/{practiceid}/{brandid}/{chartsharinggroupid}/fhir/dstu2/DiagnosticReport
List of DiagnosticReport resources from the results of the search
Was this information helpful?
Yes | No
Thank you for your feedback!
What went wrong?
Incomplete or incorrect information |
Irrelevant Content
| Others
Submit
Input Parameters
Expand all❙ required
practiceid
integer
practiceid
brandid
integer
brandid
chartsharinggroupid
integer
chartsharinggroupid
patient
integer
The patient ID (same as "PATIENTID" in non-FHIR calls).
date
string
Filter results within a specific time period.
category
string
Observation category code.
code
string
One or more LOINC codes (comma delimited).
Output Parameters
Expand all
category
object
Service category
code
object
Name/Code for this diagnostic report
effectivedatetime
string
Clinically Relevant time/time-period for report
id
string
Logical id of this artifact
issued
string
DateTime this version was released
performer
object
Responsible Diagnostic Service
resourcetype
string
The type of resource
result
array
Observations - simple, or complex nested groups
status
string
registered | partial | final | corrected | appended | cancelled | entered-in-error
subject
object
The subject of the report, usually, but not always, the patient
Example Code
Get a single diagnostic report by lab result
ID.
GET
/v1/{practiceid}/{brandid}/{chartsharinggroupid}/fhir/dstu2/DiagnosticReport/{labresultid}
DiagnosticReport resource from given ID
Was this information helpful?
Yes | No
Thank you for your feedback!
What went wrong?
Incomplete or incorrect information |
Irrelevant Content
| Others
Submit
Input Parameters
Expand all❙ required
practiceid
integer
practiceid
brandid
integer
brandid
chartsharinggroupid
integer
chartsharinggroupid
labresultid
integer
labresultid
patient
integer
The patient ID (same as "PATIENTID" in non-FHIR calls).
Output Parameters
Expand all
category
object
Service category
code
object
Name/Code for this diagnostic report
effectivedatetime
string
Clinically Relevant time/time-period for report
id
string
Logical id of this artifact
issued
string
DateTime this version was released
performer
object
Responsible Diagnostic Service
resourcetype
string
The type of resource
result
array
Observations - simple, or complex nested groups
status
string
registered | partial | final | corrected | appended | cancelled | entered-in-error
subject
object
The subject of the report, usually, but not always, the patient
Example Code
Find clinical impresssions for a given
patient.
GET
/v1/{practiceid}/{departmentid}/fhir/dstu2/ClinicalImpression
No description
Was this information helpful?
Yes | No
Thank you for your feedback!
What went wrong?
Incomplete or incorrect information |
Irrelevant Content
| Others
Submit
Input Parameters
Expand all❙ required
practiceid
integer
practiceid
departmentid
integer
departmentid
patient
integer
The patient ID (same as "PATIENTID" in non-FHIR calls).
_lastupdated
string
Last updated filter
mostrecent
integer
If true, only retrieve the most recent clinical impression.
Output Parameters
Expand allExample Code