General Information
The connectivity of this FHIR endpoint is as follows:
- HTTP Method
- GET, POST
- URL Template
- https://portal.viewmymed.com/fhir/DiagnosticReport?_id=token&
_count=number& date=date& _pretty=boolean& category=token& code=token - Supported OAuth 2.0 User Types
- Backend Systems, Clinicians or Administrative Users, Patients
- Operations Supported
- read search-type vread history-instance
- Scopes Supported
-
- patient/DiagnosticReport
- user/DiagnosticReport
- system/DiagnosticReport
- system/*.read
- system/*.rs
- Profiles Supported
-
- Us Core Diagnosticreport Note
- Us Core Diagnosticreport Lab
Request Parameters
The following fields and datatypes are the parameters for the request string. All fields are optional, however if no settings are set, all values will be exported up to the maximum count of 100
| Name (type) | Description (bindings) |
|---|---|
| _id (token) |
A single or comma separated list of DiagnosticReport ids. It is a required field if the patient field is not given. |
| _count (number) |
The maximum number of results to return in a page. Not honored when '_id' is set. |
| date (date) |
A date or date range from which to find diagnosticreport. The 'date' parameter may be provided once without a prefix or time component to imply a date range or once without a prefix and with a time component to search for diagnosticreport at a specific time. Alternately it may be provided twice with 'le' and 'gt' prefixes to search for diagnosticreport within a specific range. The date prefix pair must create a closed range. |
| _pretty (boolean) |
set to false to disable formatted output. |
| category (token) |
Which diagnostic discipline/department created the report. |
| code (token) |
The code for the report. |
Returned Data Fields
The following fields and bindings are returned if valued
| Field (type) | Description (bindings) | Opt? |
|---|---|---|
| id (Id) |
Id |
|
| subject (Reference) |
Reference to a patient resource for whom the report is relevant |
|
| encounter (Reference) |
Reference to a patient encounter for whom the report is relevant |
|
| identifier (Id) |
Unique identifier for this scan record if document is scanned. |
|
| status (String) |
Whether the document is completed/final or otherwise. DiagnosticReportStatus (http://hl7.org/fhir/diagnostic-report-status) |
|
| issued (DateTime) |
The date and time that this version of the report was made available to providers, typically after the report was reviewed and verified. |
|
| effectiveDateTime (DateTime) |
The time or time-period the observed values are related to. When the subject of the report is a patient, this is usually either the time of the procedure or of specimen collection(s), but very often the source of the date/time is not known, only the date/time itself. |
|
| code (CodeableConcept) |
A code or name that describes this diagnostic report. LOINC (http://loinc.org) |
|
| category (CodeableConcept) |
A code that classifies the clinical discipline, department or diagnostic service that created the report (e.g. cardiology, biochemistry, hematology, MRI). This is used for searching, sorting and display purposes. US Core DiagnosticReport Profile for Laboratory Results Reporting (http://hl7.org/fhir/v2/0074) LOINC (http://loinc.org) |
|
| presentedForm (Attachment) |
If the document has a scan or rendered document, this attachment represents this document. I.E. Lab results may not have a presented form. |
Default Patient Query
The following are live queries representative of a data request on our sandbox environment.
Headers
Accept: application/fhir+json Authorization: <OAuth2 Bearer Token>
Request
GET https://portal.viewmymed.com/fhir/DiagnosticReport?_id=ba4930ab7dc77310169eb3efe8f69d39
HTTP/1.0 200 OK
Cache-Control: no-cache, private
Content-Type: application/fhir+json
Date: Mon, 02 Feb 2026 13:38:50 GMT
Etag: W/"1"
{
"resourceType": "DiagnosticReport",
"id": "ba4930ab7dc77310169eb3efe8f69d39",
"identifier": [
{
"use": "usual",
"system": "urn:oid:2.16.840.1.113883.3.8023.99.99997",
"value": "99997.00033401"
}
],
"meta": {
"versionId": "ba4930ab7dc77310169eb3efe8f69d39",
"lastUpdated": "2023-01-18T04:16:55+00:00"
},
"subject": {
"reference": "Patient/99997.122753-00"
},
"encounter": {
"reference": "Encounter/59a9d34cd65224c1b37260122777ea68"
},
"status": "final",
"issued": "2023-01-04T00:00:00+00:00",
"effectiveDateTime": "2023-01-04T00:00:00+00:00",
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "LP7839-6",
"display": "Pathology Report Narrative"
}
],
"text": "Pathology Report Narrative"
},
"category": [
{
"coding": [
{
"system": "http://loinc.org",
"code": "LP7839-6",
"display": "Pathology Report Narrative"
}
],
"text": "Pathology Report Narrative"
}
],
"presentedForm": [
{
"contentType": "text/rtf",
"url": "https://portal.viewmymed.com/fhir/Binary/ba4930ab7dc77310169eb3efe8f69d39"
}
]
}
Error Codes / Outcomes
All endpoints share the same error codes and common outcomes.