Profiles & Operations > DiagnosticReport Search

DiagnosticReport Search - OLIS FHIR Patient Query For Providers

DiagnosticReport search is simple RESTful interactions. It supports retrieving a lab results from OLIS for a provider by patient ID.

Scope

This transaction involves a request by the following parameters:

The mandatory parameters for the query:

• Patient Identifier
• Gender
• Date of Birth
• Start Date

The optional parameters for the query:

• Diagnostic Report Identifier
• Test Request Code
• Observation Code
• Observation Status
• Interpretation (filter by abnormal results)
• End Date (this should default to either Observation Date or Last Updated Time in OLIS that the provider has chosen for the Start Date)

Specification

The OLIS FHIR Patient Query For Providers is based on the HL7 STU3 Search operation.

Diagnostic Report Search Request

The Diagnostic Report Search Request is an HTTP GET operation with multiple query parameters specified in Supported Search Parameters section below. The syntax of the request is

GET [base]/ DiagnosticReport?patient.identifier=[system]|[value]&patient.gender=[value]&patient.birthdate=[date]&issued=ge[date]

Note: For the more details please reference to Supported Search Parameters and Diagnostic Report Search Examples sections

Diagnostic Report Search Response

The relationship between the resources used in DiagnosticReport Search response is below:

• DiagnosticReport

• ProcedureRequest

• Observation

• Observation(MicrobiologyChild)

• Specimen

• Patient

• Practitioner(Ordering, Performing and Reporting)

• Practitioner(Copied to)

• Practitioner(Attending)

• Practitioner(Admitting)

• Organization(Ordering Facility)

• Organization(Performing Laboratoty)

• Organization(Reporting Laboratory)

• Organization(Test Request Placer)

• Organization(Specimen Collector)

• Organization(Destination Laboratory)

• Organization(Identifier Assigner)

• Organization(Requesting)

• Encounter

• OperationOutcome

• Bundle

Extensions

• practitioner-copied

• organization-orderingFacility

• organization-specimenCollector

• organization-testPlacer

• report-replaceAll

• organization-destinationLab

• EN-qualifier

• healthCard-versionCode

• data-subtype

• request-eventTiming

• specimen-numberSampleContainer

• note

• observation-sortKey

• observation-subID

• request-block

• request-pointOfCareTestID

• request-replace

• request-sortKey

Supported Search Parameters

GET DiagnosticReport (query by Patient ID)

Patient identifier parameter: patient.identifier

The patient identifier can be an Ontario health card number, or a medical record number (MRN).

• Example: patient.identifier= [id-system-global-base]/ca-on-patient-hcn|12345678

• Example of lab issued MRN: patient.identifier= http://ehealthontario.ca/fhir/NamingSystem/lab/patient-id-lab-license-4004|1234

• Example of Patient self collection assigned MRN: http://ehealthontario.ca/fhir/NamingSystem/lab/patient-id-patient-self-collection-id-1234|1233443

• Note that MRN system URI is a local identifier that contains the ID of the assigning authority (e.g. lab, hospital, specimen collection centre). For the list of possible MRN system values, please refer to Identifiers page. The patient identifiers are listed in the "Local Identifiers" table marked by "OLIS Patient Identifier generated by xxx".

Patient Gender parameter: patient.gender

• Example: patient.gender=male

Patient Date of Birth parameter: patient.birthdate

• Example: patient.birthdate=1929-11-29

Dates parameter: issued

• Example 1 : issued=ge2016-01-02

• Example 2: issued=ge2015-02-25&issued=le2016-02-27

Dates parameter: specimen.collected

• Example : specimen.collected =ge2016-01-02

Test Request code: result.based-on:ProcedureRequest.code

• Example: result.based-on:ProcedureRequest.code= [code-system-local-base] /lab/test-request-codes|TR11663-2

Interpretation parameter:result.interpretation

• Example 1: result.intepretation=AB
• Example 2: result.intepretation=CR

Note: This parameter allows the requestor to further restrict the search criteria to retrieve all abnormal results (AB) or critically abnormal only (CR).

Observation status: result.status

• Example: result.status=final

Observation code: result.code

• Example: result.code= http://loinc.org|2028-9

Diagnostic report identifier: identifier

• Example: identifier= [id-system-local-base] /lab/report-id-lab-license-4004|543321

Size limit (for response paging):_count

• Example: _count=10

If there is no _count in the search request, the server will return all matching records in one response.

Server will generate and return an additional parameter search-id as per Server Conformance section above.

• Example: search-id= 017-11-16T20:37:03.0000000X128987

Format: JSON (default) or XML

• Example: format=[mime-type]:_format=application/fhir+json or _format=application/fhir+xml

Example

Diagnostic Report Search Example

GET [base]/DiagnosticReport?patient.identifier=[id-system-global-base]/ca-on-patient-hcn|1008624486&patient.gender=male&patient.birthdate=1929-11-29&issued=ge2016-01-02 &_count=10

In the returned header:

[base]/DiagnosticReport?patient.identifier=[id-system-global-base]/ca-on-patient-hcn|1008624486&patient.gender=male&patient.birthdate=1929-11-29&issued=ge2016-01-02 &_count=10&search-id=017-11-16T20:37:03.0000000X128987

Examples of a search response can be found below