DiagnosticReport

The FHIR R4 DiagnosticReport resource represents the results of diagnostic testing performed on a patient, typically by a laboratory, imaging facility, or other diagnostic provider. It includes detailed findings, the tests performed, and may include interpretations or recommendations based on the results.

Use Cases

  • Retrieve diagnostic reports for lab results
  • Support decision-making with test results
  • Generate and share diagnostic summaries
  • Track patient progress via diagnostic reports

Base URLs

Authentication

All requests require OAuth 2.0 authentication using a Bearer Token. Unauthorized requests return 401 Unauthorized responses.

Required scopes:

  • diagnosticreport.read for GET
  • diagnosticreport.write for POST, PUT, DELETE

For more information, go to: OAuth 2.0 Authentication.

Supported Methods

MethodOperationDescription
GETRead DiagnosticReportRetrieves a specific DiagnosticReport record by its FHIR ID.
GETSearch DiagnosticReportSearches for DiagnosticReport records for a specified patient.
GETDownload DiagnosticReport as PDFRetrieves a PDF version of a specific DiagnosticReport via the $pdf operation.
POSTTrigger DiagnosticReport RetrievalInitiates retrieval of diagnostic reports via the $p360-retrieve operation.

Frequently Used Search Parameters

ParameterDescriptionFHIR Value Set / Example ValuesFHIR Data TypeRequired
patientFilters by patient IDPatient/{id}ReferenceYes
statusFilters by the status of the diagnostic reportDiagnosticReportStatus (final)tokenNo
categoryFilters by diagnostic report categoryDiagnosticReportCategory (laboratory)tokenNo
codeFilters by the test or observation performedSNOMED CT, LOINC codes (e.g., 123456)tokenNo
dateFilters by the date of the diagnostic reportge2024-01-01, le2024-12-31dateNo

Commonly Returned Resource Attributes

AttributeDescriptionExample ValuesFHIR Data TypeRequired
patientReference to the patient for whom the diagnostic report is issuedPatient/{id}Reference(Patient)Yes
statusCurrent status of the diagnostic reportfinalCodeableConceptYes
codeType of diagnostic test or observation performedSNOMED CT or LOINC codes (e.g., 123456, 7890)CodeableConceptYes
issuedDate and time when the report was issued2024-02-12T12:34:56ZdateTimeYes
categoryCategory of the diagnostic reportlaboratoryCodeableConceptNo
resultObservations or test results associated with the diagnostic reportObservation/{id}, DiagnosticReport/{id}ReferenceNo
conclusionSummary of findings or interpretations of the reportFree-textstringNo

Webhooks

Clients can subscribe to receive notifications when new diagnostic reports are generated, or when existing reports are updated or finalized. For more information, go to: Webhooks & Polling.

Error Handling

All DiagnosticReport operations follow standard Health Gorilla error handling, including use of FHIR OperationOutcome for structured responses. For more information, go to: Error Handling.

Additional Resources

HL7 FHIR DiagnosticReport